Node.js 中的 Buffer(缓冲区)

下面是关于 Node.js 中的 Buffer(缓冲区) 的系统总结,涵盖了定义、创建、读取修改、溢出处理、中文编码问题以及字符串转换等关键用法👇


🧱 一、什么是 Buffer?

Buffer 是 Node.js 提供的用于处理二进制数据 的类。

在浏览器中我们可以使用 BlobArrayBuffer,但 Node 环境下使用 Buffer 更加高效和灵活。

Buffer 主要用于处理文件系统、网络传输中的数据。


✨ 二、创建 Buffer 的几种方式

js 复制代码
// 1. 创建一个长度为 10 的 Buffer,初始值为 0
const buf1 = Buffer.alloc(10);

// 2. 创建未初始化的 Buffer(更快,但内容是旧数据,需手动填充)
const buf2 = Buffer.allocUnsafe(10);
buf2.fill(0); // 推荐立即填充

// 3. 使用数组初始化
const buf3 = Buffer.from([1, 2, 3]);

// 4. 使用字符串初始化(可指定编码)
const buf4 = Buffer.from('Hello'); // 默认 utf-8 编码
const buf5 = Buffer.from('你好', 'utf8');

🧪 三、读取和修改 Buffer 内容

js 复制代码
const buf = Buffer.from('Node');

// 读取字节值(十进制 ASCII)
console.log(buf[0]); // 输出: 78,对应字符 N

// 修改值
buf[0] = 100; // 改为字符 d (ASCII 100)
console.log(buf.toString()); // "dode"

🚫 四、Buffer 溢出处理

Buffer 是固定长度的,不能自动扩容,超出会被截断或不生效:

js 复制代码
const buf = Buffer.alloc(2);
buf.write('abcd');
console.log(buf.toString()); // 输出 ab,后面 cd 被截断

写入的数据超出长度时,只写入前面的部分。


🌏 五、Buffer 中文乱码问题处理

js 复制代码
const buf = Buffer.from('你好', 'utf8');
console.log(buf); // <Buffer e4 bd a0 e5 a5 bd>

// 将 Buffer 转回中文字符串
console.log(buf.toString('utf8')); // 你好

⚠️ 中文字符占用多个字节(通常为 3 个),不能随意截取:

js 复制代码
const cut = buf.slice(0, 2); // 截取不完整
console.log(cut.toString('utf8')); // 输出乱码

✅ 正确做法:用 iconv-lite 等库做中文切割或保留完整字节。


🔄 六、Buffer 与字符串的互相转换

js 复制代码
// 字符串 => Buffer
const str = 'hello';
const buf = Buffer.from(str);

// Buffer => 字符串
const newStr = buf.toString('utf8'); // "hello"

编码可以是:utf8asciibase64hexlatin1


🔍 七、实用方法补充

方法 说明
buf.length 返回字节长度
buf.slice(start, end) 截取部分 Buffer
buf.write(str, offset, length, encoding) 写入字符串
Buffer.concat([buf1, buf2]) 合并多个 Buffer
Buffer.isBuffer(obj) 判断是否是 Buffer

✅ 总结一句话

Buffer 是 Node 中用于处理二进制数据的核心模块,支持高效的创建、读取、写入和转换,尤其适用于网络传输和文件读写中。


需要我帮你出一个 Buffer 使用的实战示例(比如文件读取、TCP 收包等)也可以告诉我~

相关推荐
Gogo11211 小时前
构建高性能 Node.js 集中式日志体系 (下篇):Pino + PM2 + OpenSearch 代码落地实战
node.js
小岛前端1 小时前
Node.js 宣布重大调整,运行十年的规则要改了!
前端·node.js
前端付豪2 小时前
Nest 项目小实践之前端注册登陆
前端·node.js·nestjs
codingWhat19 小时前
整理「祖传」代码,就是在开发脚手架?
前端·javascript·node.js
ServBay19 小时前
Node.js、Bun 与 Deno,2026 年后端运行时选择指南
node.js·deno·bun
码路飞1 天前
Node.js 中间层我维护了两年,这周终于摊牌了——成本账单算完我人傻了
node.js
None3212 天前
【NestJs】使用Winston+ELK分布式链路追踪日志采集
javascript·node.js
Dilettante2582 天前
这一招让 Node 后端服务启动速度提升 75%!
typescript·node.js
Mr_li3 天前
NestJS 集成 TypeORM 的最优解
node.js·nestjs
UIUV3 天前
node:child_process spawn 模块学习笔记
javascript·后端·node.js