Node.js 中的 Buffer 是什么？

Question

Accepted Answer

**Buffer** 是 Node 处理 **原始二进制数据** 的方式 — 一个存储在 V8 堆外部的固定长度字节序列。由于 JavaScript 字符串用于文本（Unicode），因此存在 Buffer 来处理二进制数据：文件内容、网络数据包、图像、加密等。

## Buffer 为什么存在

```text
JavaScript strings → text (UTF-16). Can't cleanly represent arbitrary bytes.
Buffers → raw bytes (0–255 each). For binary data that isn't text.
```

当您读取文件或接收网络数据时，它以字节形式到达 — 一个 Buffer — 然后如果是文本，您可以将其解码为字符串，或如果不是，将其作为二进制处理。

## 创建和使用 Buffer

```js
const buf = Buffer.from("Hello");          // from a string → bytes
const buf2 = Buffer.from([72, 105]);       // from byte values → "Hi"
const buf3 = Buffer.alloc(10);             // 10 zero-filled bytes

buf.length;          // 5 (bytes, not characters)
buf.toString("utf8"); // "Hello" — decode back to text
buf.toString("hex");  // "48656c6c6f"
buf.toString("base64"); // "SGVsbG8="
buf[0];              // 72 — access individual bytes
```

## Buffer 出现的地方

```js
// file reads without an encoding return a Buffer
const data = await fs.promises.readFile("image.png"); // Buffer (binary)
const text = await fs.promises.readFile("file.txt", "utf8"); // string (decoded)

// streams emit Buffer chunks
req.on("data", (chunk) => { /* chunk is a Buffer */ });

// crypto, compression, network protocols all work with Buffers
crypto.randomBytes(16); // a Buffer of 16 random bytes
```

如果您读取文件时 *不指定* 编码，您会得到一个 Buffer；指定 `"utf8"`，Node 会为您将其解码为字符串。

## 一个微妙的点：字节与字符

```js
Buffer.from("café").length; // 5 (é is 2 bytes in UTF-8) — NOT 4 characters
```

Buffer 长度以 **字节** 为单位，对于多字节（非 ASCII）文本，这可能与字符数不同 — 在切片二进制数据时相关。

## 为什么这很重要

Buffer 是 Node 处理所有 **二进制数据** 的方式，这在服务器工作中是不可避免的：读取非文本文件、处理流、网络协议、密码学、图像/文件上传和压缩。

理解 I/O 基本上处理字节（Buffer）— 以及如何使用正确的编码在 Buffer 和字符串之间进行转换 — 在您超越纯文本时至关重要，它是流、文件系统和加密的基础。