Node.js 中的 Buffer缓冲区实例详解-牛翰网

🧱 一、什么是 Buffer？

Buffer 是 Node.js 提供的用于处理二进制数据的类。
在浏览器中我们可以使用 Blob 或 ArrayBuffer，但 Node 环境下使用 Buffer 更加高效和灵活。

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

二、创建 Buffer 的几种方式

// 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 内容

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 是固定长度的，不能自动扩容，超出会被截断或不生效：

const buf = Buffer.alloc(2);
buf.write('abcd');
console.log(buf.toString()); // 输出 ab，后面 cd 被截断

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

五、Buffer 中文乱码问题处理

const buf = Buffer.from('你好', 'utf8');
console.log(buf); // <Buffer e4 bd a0 e5 a5 bd>
// 将 Buffer 转回中文字符串
console.log(buf.toString('utf8')); // 你好

️ 中文字符占用多个字节（通常为 3 个），不能随意截取：

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

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

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

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

编码可以是：utf8、ascii、base64、hex、latin1 等

七、实用方法补充

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