Node.js / 系统课时

认识 Buffer

认识 Buffer

Buffer 用来在 Node.js 中保存和处理原始字节。文件、网络包、压缩数据和图片都不是普通 JavaScript 字符串;掌握 Buffer 后,你可以明确知道内存里有多少字节、每个字节是什么,以及何时把它还原成文本。

学习目标

  • 理解 Buffer 保存字节而不是“字符”的含义。
  • 会用 Buffer.from()、Buffer.alloc() 创建缓冲区,并知道何时避免 Buffer.allocUnsafe()。
  • 会读取字节、查看十六进制内容,并把字节按指定编码还原成字符串。

Buffer 保存的是字节

一个 Buffer 可以看作按偏移排列的一串 8 位无符号整数,每个元素范围是 0~255。例如 UTF-8 文本 A 只占 1 字节,而 你 占 3 字节,所以“字符数”和“字节数”不能混用。

内容 UTF-8 十六进制字节 字节数
A 41 1
你 e4 bd a0 3
你好A e4 bd a0 e5 a5 bd 41 7

因此 Buffer.from('你好A', 'utf8').length 是 7。如果协议规定“消息体最多 64 字节”,应使用 Buffer.byteLength(text, 'utf8') 或已经生成的 Buffer.length 检查,不能直接拿字符串的 .length 代替。

创建 Buffer 时先看数据来源

常用创建方式只需记住四种。新代码不要使用旧式 new Buffer(...),这样可以避免数字参数含义不清和未初始化内存带来的风险。

写法 适合场景 结果
Buffer.from('OK', 'utf8') 文本转字节 得到 4f 4b
Buffer.from([0x4f, 0x4b]) 已知原始字节 得到 4f 4b
Buffer.alloc(4) 需要固定长度并从零开始写入 4 个字节初始全为 00
Buffer.allocUnsafe(4) 性能敏感且会立刻覆盖全部字节 内容未初始化,读取前必须完整写满

一般业务代码优先使用 Buffer.alloc()。只有在你能保证分配后立刻覆盖整个缓冲区、并且确实需要减少初始化开销时,才考虑 Buffer.allocUnsafe()。

用一个程序观察字节

下面示例同时演示文本转字节、按索引读取、按编码解码,以及向固定长度缓冲区写入一个 16 位大端整数。保存为 buffer-demo.js 后执行 node buffer-demo.js。

js
const { Buffer } = require('node:buffer');

const text = '你好A';
const fromText = Buffer.from(text, 'utf8');
const fromBytes = Buffer.from([0xe4, 0xbd, 0xa0]);

const packet = Buffer.alloc(4);
// 前两个字节写入 0x1234,使用大端顺序。
packet.writeUInt16BE(0x1234, 0);
packet[2] = 0xaa;
packet[3] = 0x55;

console.log('text bytes:', fromText.length);
console.log('hex:', fromText.toString('hex'));
console.log('first byte:', fromText[0]);
console.log('decoded:', fromText.toString('utf8'));
console.log('from bytes:', fromBytes.toString('utf8'));
console.log('packet:', packet.toString('hex'));

预期输出

text
text bytes: 7
hex: e4bda0e5a5bd41
first byte: 228
decoded: 你好A
from bytes: 你
packet: 1234aa55

fromText[0] 返回十进制 228,也就是十六进制 e4。writeUInt16BE(0x1234, 0) 从偏移 0 开始写两个字节,所以缓冲区前两位依次是 12 34;后两个字节由索引 2、3 写入。

在真实项目里什么时候用 Buffer

读取二进制文件、处理 TCP/UDP 数据、计算哈希、解压缩图片或拼接协议包时,应让数据保持为 Buffer,直到业务边界明确要求文本。纯文本业务则相反:进入程序时按正确编码解码成字符串,业务处理中使用字符串,只在写文件或发网络请求前再转回字节。

一个实用检查规则是:只要你关心的是“第几个字节、报文长度、文件内容、哈希输入”,优先使用 Buffer;只要你关心的是“第几个字符、文本搜索、模板拼接”,优先使用字符串。混用两者时,始终把编码名称写出来,避免依赖默认值造成误判。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

认识 Buffer

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通