Base64工具库：编码与解码工具类（239）

发布时间：2026/10/14 17:39:16

Base64工具库：编码与解码工具类（239）
在鸿蒙HarmonyOS应用开发中Base64 编码与解码是处理二进制数据与文本协议转换的基石广泛应用于 Token 传输、图片转字符串、文件加密等场景。鸿蒙官方提供了底层且高性能的buffer模块同时社区也封装了更为便捷的Base64Util工具类一、 官方原生方案Buffer 模块实战场景在不引入第三方库的情况下利用鸿蒙原生的kit.ArkTS中的buffer模块实现字符串与 Base64 之间的双向转换。import { buffer } from kit.ArkTS; // 1. 字符串编码为 Base64 const plainText Hello HarmonyOS; const base64Str buffer.from(plainText, utf-8).toString(base64); console.info(编码结果:, base64Str); // 输出: SGVsbG8gSGFybW9ueU9T // 2. Base64 解码还原为字符串 const decodedText buffer.from(base64Str, base64).toString(utf-8); console.info(解码结果:, decodedText); // 输出: Hello HarmonyOS // 3. 处理二进制文件如图片的 Base64 转换 const imageArray new Uint8Array([0x89, 0x50, 0x4E, 0x47]); // 模拟图片字节 const imageBase64 buffer.from(imageArray).toString(base64);二、 社区进阶方案Base64Util 工具类场景在大型项目中将 Base64 的转换逻辑、异常捕获和 URL 安全处理封装为全局单例工具类提升代码复用率。import { buffer } from kit.ArkTS; export class Base64Util { // 1. 标准 Base64 编码 static encode(input: string | Uint8Array): string { try { if (typeof input string) { return buffer.from(input, utf-8).toString(base64); } return buffer.from(input).toString(base64); } catch (err) { console.error(Base64 编码失败:, err); return ; } } // 2. 标准 Base64 解码 static decode(base64Str: string): string { try { return buffer.from(base64Str, base64).toString(utf-8); } catch (err) { console.error(Base64 解码失败:, err); return ; } } // 3. URL 安全的 Base64 编码将 替换为 -/ 替换为 _去掉 static encodeUrlSafe(input: string): string { return Base64Util.encode(input).replace(/\/g, -).replace(/\//g, _).replace(/$/, ); } }三、 高阶实战大文件流式 Base64 转换场景当需要处理几 MB 甚至更大的文件如视频、高清图片时直接将其全部转为 Base64 会导致内存溢出OOM。必须采用分片读取与转换策略。import { fileIo as fs } from kit.CoreFileKit; import { Base64Util } from ./Base64Util; async function largeFileToBase64(filePath: string): Promisestring { const file fs.openSync(filePath, fs.OpenMode.READ_ONLY); const chunkSize 3 * 1024; // 每次读取 3KB3的倍数避免 Base64 截断错位 const bufferArray new Uint8Array(chunkSize); let base64Result ; let readLen 0; while ((readLen fs.readSync(file.fd, bufferArray)) 0) { const chunk bufferArray.subarray(0, readLen); base64Result Base64Util.encode(chunk); } fs.closeSync(file); return base64Result; }内存膨胀预警Base64 编码会使数据体积增加约33%。在处理大文件时严禁在主线程一次性转换必须结合TaskPool分片处理防止引发应用崩溃。URL 传参陷阱标准的 Base64 包含和/字符在作为 URL 参数传递时会被浏览器或服务器错误转义。涉及网络传输时务必使用 URL 安全的 Base64 变体URL-Safe Base64。去除 BOM 头在解码由其他系统生成的 Base64 字符串时可能会遇到隐藏的 BOM 头导致解码乱码。建议在解码前执行base64Str.trim()清理首尾空白字符。图片预览规范如果将 Base64 字符串直接赋值给鸿蒙Image组件的src属性必须加上数据 URI 前缀例如data:image/png;base64,${base64Str}否则图片将无法渲染。四、 官方 Base64Helper 完整的编码与解码管道场景使用鸿蒙官方推荐的util.Base64Helper结合TextEncoder/TextDecoder构建标准的字符串与 Base64 互转管道彻底解决中文乱码问题。import { util } from kit.ArkTS; export class Base64Pipe { // 字符串 - Base64 static encode(input: string): string { let encoder new util.TextEncoder(utf-8); let uint8Array encoder.encodeInto(input); let helper new util.Base64Helper(); return helper.encodeToStringSync(uint8Array); } // Base64 - 字符串 static decode(input: string): string { let helper new util.Base64Helper(); let uint8Array helper.decodeSync(input); let decoder util.TextDecoder.create(utf-8); // 注意使用静态工厂方法 return decoder.decodeToString(uint8Array); } }五、高阶封装支持同步/异步与 Uint8Array 转换场景在复杂业务中既需要处理文本也需要处理二进制文件Uint8Array同时需要异步方法避免阻塞主线程。import { util } from kit.ArkTS; export class Base64Util { private static createHelper(): util.Base64Helper { return new util.Base64Helper(); } // 二进制编码为 Base64 字符串同步 static encodeToStrSync(array: Uint8Array): string { return Base64Util.createHelper().encodeToStringSync(array); } // Base64 解码为二进制异步 static async decode(input: string): PromiseUint8Array { return Base64Util.createHelper().decode(input); } }六、图片与 PixelMap Base64 与图像互转场景将相册选中的图片转为 Base64 字符串用于上传或将网络返回的 Base64 字符串还原为 PixelMap 进行 UI 展示。import { image, util } from kit.ArkTS; // 将图片二进制数据转为 Base64 function pixelMapToBase64(pixelMap: image.PixelMap): string { let num pixelMap.getPixelBytesNumber(); let readBuffer new ArrayBuffer(num); pixelMap.readPixelsToBufferSync(readBuffer); let helper new util.Base64Helper(); return helper.encodeToStringSync(new Uint8Array(readBuffer)); } // 将 Base64 还原为 PixelMap function base64ToPixelMap(base64Str: string, width: number, height: number): image.PixelMap { let helper new util.Base64Helper(); let imageUint8 helper.decodeSync(base64Str).buffer; let opts: image.InitializationOptions { editable: true, size: { height: height, width: width } }; return image.createPixelMapSync(imageUint8, opts); }

相关新闻

运动耳机如何选出舒适好用的？实测十款热门耳机，揭晓综合实力

运动耳机如何选出舒适好用的？实测十款热门耳机，揭晓综合实力

市面上开放式运动耳机款式繁多，各类品牌机型参数眼花缭乱，不少人选购时很难分辨真实佩戴与使用差距。本次集合十款主流运动耳机完成完整横向测评，摒弃单一纸面参数对比，结合真机实测数据、日常佩戴感受、户外运动耐久多维度真实测…

2026/10/14 9:04:58 阅读更多 →
深入解析TMS320F2837xD时钟与中断安全机制，构建高可靠嵌入式系统

深入解析TMS320F2837xD时钟与中断安全机制，构建高可靠嵌入式系统

1. 项目概述与核心价值在工业控制、新能源汽车电驱或者高精度伺服系统里摸爬滚打过的工程师，对TI的C2000系列DSP都不会陌生。而TMS320F2837xD作为其双核旗舰，把实时控制性能推到了一个新高度。但性能强大的同时，系统的复杂度和可靠性要求也水…

2026/10/5 20:25:20 阅读更多 →
【飞书AI审批提效300%实战指南】：20年流程专家亲授5大避坑法则与3套即插即用模板

【飞书AI审批提效300%实战指南】：20年流程专家亲授5大避坑法则与3套即插即用模板

更多请点击： https://codechina.net 第一章：飞书AI审批流程优化的底层逻辑与价值重构 飞书AI审批并非简单叠加大模型能力，而是以事件驱动架构（EDA）为基座，将审批行为解耦为可编排、可观测、可干预的原子单…

2026/9/27 17:16:56 阅读更多 →

最新新闻

STM32F103ZET6库函数工程从零搭建实战指南

STM32F103ZET6库函数工程从零搭建实战指南

1. 为什么今天还要从零搭建一个“老”芯片的库函数工程？在2024年，当RISC-V开发板满天飞、Cortex-M33芯片已成中端主力、AIoT项目动辄集成Wi-FiBLERTOS的时候，我依然在Keil MDK里，为一块STM32F103ZET6——这颗2007年发布、主频72MH…

2026/10/14 17:39:02 阅读更多 →
Python入门必学：输入输出、流程控制与循环语句详解

Python入门必学：输入输出、流程控制与循环语句详解

1. 初见Python：为什么第一篇只讲这三件事如果你问一百个Python老手"入门的核心语法到底是什么"，其中九十个会告诉你：先把输入输出、流程控制、循环语句这三样吃透，其他的都可以往后放。这看起来很简单，但恰恰…

2026/10/14 17:39:02 阅读更多 →
系统设计面试全攻略：从需求澄清到容量估算的实战框架

系统设计面试全攻略：从需求澄清到容量估算的实战框架

简介：《System Design Interview》是面向求职者的系统设计面试经典读物，作者Alex Xu曾任职Twitter、Apple等公司，全书旨在帮读者系统应对模糊且宏大的架构设计题。资源为PDF格式，1个文件、约9.97MB，便于离线阅读与检索…

2026/10/14 17:39:02 阅读更多 →
aiogram 3.x 路由系统（Router）完全指南：事件分发、嵌套路由与更新传播机制

aiogram 3.x 路由系统（Router）完全指南：事件分发、嵌套路由与更新传播机制

后端即时通讯API设计 【免费下载链接】aiogram aiogram is a modern and fully asynchronous framework for Telegram Bot API written in Python using asyncio 项目地址： https://gitcode.com/gh_mirrors/ai/aiogram 点击查看 免费下载 导读 本文是 aiogram 3.x…

2026/10/14 17:39:02 阅读更多 →
磷化工企业供应链降本实战：从磷矿到磷酸铁锂的运营效率密码

磷化工企业供应链降本实战：从磷矿到磷酸铁锂的运营效率密码

最近我把某磷化集团2025年的三季报翻了个底朝天，又对着它的供应链流程做了好几轮复盘。这家公司手里攥着8亿吨磷矿资源储量（此处为虚构案例表述），全年净利润预测到了47亿，Q3单季增速直接冲上20%。坦白讲，资…

2026/10/14 17:39:02 阅读更多 →
Wechaty 集成 wechatferry：用 @wechatferry/puppet 实现 PC Hook 微信机器人的完整实践

Wechaty 集成 wechatferry：用 @wechatferry/puppet 实现 PC Hook 微信机器人的完整实践

即时通讯后端AI 应用 【免费下载链接】wechatferry - 项目地址： https://gitcode.com/gh_mirrors/wec/wechatferry 点击查看 免费下载 本文围绕 wechatferry 仓库中的 Wechaty 集成文档 docs/integrations/wechaty.md 展开，讲解如何通过 wechatferry/pu…

2026/10/14 17:38:02 阅读更多 →

日新闻

AnyPS5通用适配层设计：兼容性与性能的工程取舍

AnyPS5通用适配层设计：兼容性与性能的工程取舍

1. 从"AnyPS5"这个名字说起：它到底想解决什么问题第一次看到"AnyPS5"这个标题，我脑子里冒出来的第一个念头是：这大概率是一个围绕"跨平台运行"或者"通用适配"做文章的项目。名字里的"Any"…

2026/10/14 0:00:41 阅读更多 →
Flutter跨平台开发实战：二手交易应用与HarmonyOS适配

Flutter跨平台开发实战：二手交易应用与HarmonyOS适配

1. 项目概述：Flutter跨平台二手交易应用开发作为一名长期从事移动应用开发的工程师，我最近完成了一个基于Flutter框架的二手物品交易平台项目。这个项目最吸引我的地方在于它完美结合了Flutter的跨平台优势与HarmonyOS的生态特性，实现了"…

2026/10/14 0:00:41 阅读更多 →
DFS算法解决飞机降落调度问题实战

DFS算法解决飞机降落调度问题实战

1. 项目背景与核心思路飞机降落问题是一个经典的调度优化场景，也是算法竞赛和面试中的高频题目。这个题目要求我们合理安排多架飞机的降落顺序和时间，确保所有飞机都能安全着陆而不发生冲突。在实际航空管制中，这类问题直接关系到飞行安全和机…

2026/10/14 0:00:41 阅读更多 →

周新闻

流感时间序列预测实战：ARIMA/LSTM全流程拆解与避坑指南

流感时间序列预测实战：ARIMA/LSTM全流程拆解与避坑指南

简介：基于 ARIMA、LSTM、Transformer 等模型的流感时间序列预测 Python 源码，面向计算机相关专业课程设计与期末大作业学生，以及项目实战学习者。内容覆盖预处理、平稳性检验、定阶、残差分析、多模型对比预测的完整时序建模流程，…

2026/10/14 3:30:28 阅读更多 →
影刀RPA新手教程：键盘模拟输入实战——输入文本与模拟按键的区别

影刀RPA新手教程：键盘模拟输入实战——输入文本与模拟按键的区别

影刀RPA新手教程：键盘模拟输入实战——输入文本与模拟按键的区别 做影刀RPA自动化，十个新手有八个栽在"往输入框里填东西"这件事上：要么填不进去，要么填了一半，要么直接把原来内容追加在后面。这背后的根因&…

2026/10/14 16:30:29 阅读更多 →
影刀RPA新手教程：阅文起点小说数据采集实战——书籍信息与章节内容

影刀RPA新手教程：阅文起点小说数据采集实战——书籍信息与章节内容

影刀RPA新手教程：阅文起点小说数据采集实战——书籍信息与章节内容 1. 认识影刀：什么场景该用RPA采小说数据 起点中文网的页面结构相对稳定——分类榜单、书籍详情、章节内容三块独立页面，跳转链路清晰。这种场景非常适合影刀自动化&#x…

2026/10/14 3:29:58 阅读更多 →

月新闻

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/13 22:01:27 阅读更多 →
Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/13 14:57:39 阅读更多 →
黑夜航拍船只数据集训练YOLOV5模型全流程解析

黑夜航拍船只数据集训练YOLOV5模型全流程解析

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/10/14 7:53:34 阅读更多 →