Node.js中正确读写Uint16Array的方法

嘿，我完全懂你的感受——那个绕来绕去的临时Uint8Array转换不仅看起来别扭，处理大文件时还可能带来不必要的内存开销，确实得换个更直接的方式。咱们先搞清楚问题出在哪，再给出最优解。

为什么直接用Buffer创建Uint16Array会出错？ #

Node.js的fs.readFile返回的Buffer本质上是Uint8Array的子类，但当你直接把Buffer传给Uint16Array构造函数时，它会把Buffer当成普通数组遍历：逐个取出每个字节，把它们作为独立的Uint16元素。这就导致原本的[0,1,2,...]（每个元素占2字节）被拆成了[0,0,1,0,2,0,...]，完全不符合预期。

更简洁高效的解决方案 #

其实Buffer本身就暴露了底层的ArrayBuffer（通过buf.buffer属性），还提供了byteOffset来标记它在ArrayBuffer中的起始位置。我们可以直接用这两个属性来创建Uint16Array，跳过多余的转换步骤：

优化后的完整代码 #

"use strict";
const fs = require("fs").promises;

(async () => {
    // 直接创建并填充Uint16Array（无需先手动创建ArrayBuffer）
    const a = new Uint16Array(10);
    for(let i = 0; i < a.length; ++i) {
        a[i] = i;
    }

    // 写入文件：直接传入Uint16Array的底层ArrayBuffer
    await fs.writeFile("test.bin", a.buffer, "binary")
        .catch(err => console.error("写入错误：", err));

    // 读取二进制文件
    const buf = await fs.readFile("test.bin")
        .catch(err => console.error("读取错误：", err));

    // 直接基于Buffer的底层ArrayBuffer创建Uint16Array
    // 第三个参数是元素个数：总字节数 / 每个Uint16的字节数（2）
    const b = new Uint16Array(buf.buffer, buf.byteOffset, buf.length / 2);

    console.log("原始数组a:", a);
    console.log("读取后数组b:", b);
})();

额外注意事项 #

• 文件名建议用.bin后缀：因为我们处理的是二进制数据，用.txt可能会让文本编辑器误处理（比如自动转码），导致文件损坏。
• 字节序问题：默认情况下，Uint16Array和Node.js的Buffer都采用小端序（little-endian）。如果你的文件是大端序（big-endian）格式，需要用DataView来正确读取：

  const b = new Uint16Array(buf.length / 2);
  const dataView = new DataView(buf.buffer, buf.byteOffset);
  for(let i = 0; i < b.length; ++i) {
      // 第二个参数false表示大端序，true表示小端序
      b[i] = dataView.getUint16(i * 2, false);
  }
  

这样处理不仅去掉了冗余的临时转换，还能更高效地处理大文件——因为我们直接复用了Buffer的底层内存，没有额外复制数据。

内容的提问来源于stack exchange，提问作者Harry Svensson