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。
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 bytes: 7
hex: e4bda0e5a5bd41
first byte: 228
decoded: 你好A
from bytes: 你
packet: 1234aa55fromText[0] 返回十进制 228,也就是十六进制 e4。writeUInt16BE(0x1234, 0) 从偏移 0 开始写两个字节,所以缓冲区前两位依次是 12 34;后两个字节由索引 2、3 写入。
在真实项目里什么时候用 Buffer
读取二进制文件、处理 TCP/UDP 数据、计算哈希、解压缩图片或拼接协议包时,应让数据保持为 Buffer,直到业务边界明确要求文本。纯文本业务则相反:进入程序时按正确编码解码成字符串,业务处理中使用字符串,只在写文件或发网络请求前再转回字节。
一个实用检查规则是:只要你关心的是“第几个字节、报文长度、文件内容、哈希输入”,优先使用 Buffer;只要你关心的是“第几个字符、文本搜索、模板拼接”,优先使用字符串。混用两者时,始终把编码名称写出来,避免依赖默认值造成误判。