Node.js的Buffer类用于处理二进制数据,支持字符串、数组创建及内存分配,可进行读写、转换、拼接操作,广泛应用于文件、网络流处理。

Node.js 的 Buffer 类是处理二进制数据的核心工具,特别适用于操作原始字节流,比如文件读写、网络传输、加密解密等场景。由于 JavaScript 原生不支持直接操作二进制数据,Buffer 提供了在 V8 引擎之外分配原始内存的能力,让开发者可以在不依赖浏览器 ArrayBuffer 的情况下高效处理字节。
创建 Buffer 实例
你可以通过多种方式创建 Buffer:
- 从字符串创建:指定编码格式(如 utf8、hex、base64)将字符串转为字节
- 从数组创建:传入字节数组生成 Buffer
- 分配固定长度的空 Buffer:初始化指定大小的未初始化内存(内容可能随机)
- 安全分配初始化 Buffer:自动填充为 0,更安全但稍慢
const buf1 = Buffer.from('Hello', 'utf8');
const buf2 = Buffer.from([0x48, 0x65, 0x6c, 0x6c, 0x6f]); // 对应 "Hello"
const buf3 = Buffer.allocUnsafe(10);
const buf4 = Buffer.alloc(10);
读写与转换 Buffer 数据
Buffer 支持按索引访问和修改字节,也能与其他数据格式互转:
- 读取单个字节:返回 ASCII 码值
- 修改字节:直接赋值修改对应位置
- 转回字符串:使用 toString() 指定编码
- 转为普通数组:方便调试或进一步处理
console.log(buf1[0]); // 输出 72 (H 的 ASCII)
buf1[0] = 74; // 将 'H' 改为 'J'
console.log(buf1.toString('utf8')); // 输出 "Jello"
console.log(buf1.toJSON()); // 输出 [74, 101, 108, 108, 111]
处理流中的二进制数据
在处理文件或网络流时,数据通常以 Buffer 形式分段到达。例如使用 fs 模块读取图片或视频:
const fs = require('fs');
fs.createReadStream('image.png')
.on('data', (chunk) => {
console.log(`收到 ${chunk.length} 字节`);
console.log(chunk instanceof Buffer); // true
})
.on('end', () => {
console.log('读取完成');
});
在网络服务中,HTTP 请求体也可能包含二进制数据:
let body = [];
request.on('data', (chunk) => {
body.push(chunk);
});
request.on('end', () => {
const fullData = Buffer.concat(body);
console.log(fullData.toString('utf8'));
});
常见操作技巧
- 合并多个 Buffer:使用 Buffer.concat()
- 检查是否为 Buffer:避免类型错误
- 截取部分数据:类似数组 slice
const merged = Buffer.concat([buf1, buf2], buf1.length + buf2.length);
Buffer.isBuffer(someVar); // 返回布尔值
const part = buf1.slice(1, 4); // 取第 1 到 3 位
基本上就这些。掌握 Buffer 的创建、读写、拼接和流处理方式,就能高效应对 Node.js 中的二进制任务。注意选择合适的分配方法(alloc vs allocUnsafe),并在处理用户输入时验证数据类型,避免潜在问题。










