Buffer 是 Node.js 中用于高效操作二进制数据的核心类，适用于 TCP 流、文件 I/O 和网络请求。它在 V8 堆外分配固定大小的内存块，以 8 位字节存储数据，支持通过索引访问，每个字节范围为 0 到 255。创建方式包括 Buffer.from()、Buffer.alloc() 和 Buffer.allocUnsafe()，例如 Buffer.from('hello') 将字符串按 UTF-8 编码为字节序列。Buffer 常与 Stream 配合使用，处理大数据时分块读取，可读流通过 'data' 事件 emit Buffer 数据块，便于累积和解析上传内容。它支持多种编码转换，如 UTF-8、Base64、Hex，需明确指定编码避免乱码。性能方面，Buffer 支持零拷贝操作，如 fs.readSync 直接写入指定 Buffer 区域，提升效率；Buffer.allocUnsafe() 跳过清零加快分配，但需确保初始化安全。Buffer 与 TypedArray 共享底层 ArrayBuffer，可相互转换。尽管高级 API 常封装其细节，但在高性能或协议解析场景中仍至关重要。
Buffer 类在 Node.js 中用于直接操作二进制数据，特别适用于处理 TCP 流、文件 I/O 或网络请求中的原始字节。由于 JavaScript 原生对二进制支持有限，Buffer 提供了在 V8 堆外分配内存的能力，从而实现高效的数据读写。
直接操作原始字节
Buffer 实例是固定大小的内存块，以 8 位字节为单位存储数据，可以像数组一样通过索引访问每个字节。
- 创建 Buffer 可使用 Buffer.from()、Buffer.alloc() 或 Buffer.allocUnsafe()
- 例如：const buf = Buffer.from('hello'); 会将字符串编码为 UTF-8 字节序列
- 每个元素范围是 0 到 255，超出范围会被截断或模运算处理
与流（Stream）配合处理大数据
在处理大文件或网络传输时，不可能一次性加载全部数据到内存。Buffer 与 Readable/Writeable 流结合，实现分块处理。
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 可读流（如文件读取或 HTTP 请求）会以 Buffer 形式 emit 数据块
- 监听 'data' 事件时，接收到的 chunk 就是 Buffer 实例
- 示例：HTTP 服务器接收上传文件时，用 Buffer 累积片段再解析
支持多种编码转换
Buffer 能在常见编码格式间转换，比如 UTF-8、ASCII、Base64、Hex 等，适合处理跨系统数据交换。
- Buffer.from('abc', 'utf8') 创建 UTF-8 编码的 Buffer
- buf.toString('base64') 将 Buffer 转为 Base64 字符串
- 避免乱码的关键是明确指定输入输出的编码方式
零拷贝与性能优化
某些 API 支持传入预分配的 Buffer 直接写入，减少内存复制开销。
- 如 fs.readSync(fd, buffer, offset, length, position) 把文件内容直接读入指定 Buffer 区域
- 使用 Buffer.allocUnsafe() 可跳过清零步骤提升性能，但需确保正确初始化
- TypedArray 与 Buffer 共享底层 ArrayBuffer，可在需要时相互转换
基本上就这些。Buffer 是 Node.js 处理底层 I/O 的核心工具，掌握其创建、编码和流集成方式，能更高效地应对二进制数据场景。虽然现代开发中常被高级封装隐藏，但在性能敏感或协议解析等场景仍不可或缺。
