Node环境下如何将Typed Array写入大端字节序的二进制文件（非大端机器）

这个问题其实挺常见的——毕竟现在大部分机器都是小端架构，但很多二进制文件格式要求用大端字节序（也就是网络字节序）。在Node.js里处理这个转换并不复杂，给你两种实用的方案：

DataView是专门用来处理ArrayBuffer的工具，它允许你明确指定字节序（大端true或者小端false），完全不受主机架构影响。不管你的机器是小端还是大端，都能精准写出大端字节序的二进制数据。

举个例子，假设你有一组16位无符号整数，要写入大端字节序的文件：

const fs = require('fs').promises;

async function writeBigEndianFile() {
  // 假设这是你的原始数据
  const originalData = [1000, 2000, 3000];
  
  // 创建足够容纳数据的ArrayBuffer（每个Uint16占2字节）
  const buffer = new ArrayBuffer(originalData.length * 2);
  const dataView = new DataView(buffer);
  
  // 逐个以大端模式写入数据
  originalData.forEach((value, index) => {
    // 第二个参数true表示使用大端字节序
    dataView.setUint16(index * 2, value, true);
  });
  
  // 把ArrayBuffer转成Node.js的Buffer，然后写入文件
  const nodeBuffer = Buffer.from(buffer);
  await fs.writeFile('output.bin', nodeBuffer);
  console.log('大端字节序文件写入完成');
}

writeBigEndianFile().catch(err => console.error(err));

如果你的原始数据已经是Typed Array（比如Uint16Array），也可以用同样的方式处理：

const fs = require('fs').promises;

async function convertTypedArrayToBigEndian() {
  // 假设这是已有的Typed Array（主机字节序，这里是小端）
  const typedArray = new Uint16Array([1000, 2000, 3000]);
  
  const buffer = new ArrayBuffer(typedArray.byteLength);
  const dataView = new DataView(buffer);
  
  typedArray.forEach((value, index) => {
    dataView.setUint16(index * 2, value, true);
  });
  
  const nodeBuffer = Buffer.from(buffer);
  await fs.writeFile('output.bin', nodeBuffer);
}

convertTypedArrayToBigEndian().catch(err => console.error(err));

Node.js的Buffer内置了swap16()、swap32()、swap64()方法，可以直接把小端字节序的Buffer转换成大端（反之亦然）。这个方法更适合已经有Typed Array，且需要快速转换的场景。

注意：这个方法的前提是你的主机确实是小端架构（你说通常是这种情况），因为Buffer默认使用主机字节序存储多字节数据。

示例代码：

const fs = require('fs').promises;

async function swapAndWriteFile() {
  // 已有Typed Array（小端字节序）
  const typedArray = new Uint16Array([1000, 2000, 3000]);
  
  // 把Typed Array转成Buffer
  let buffer = Buffer.from(typedArray.buffer);
  
  // 如果是Uint16Array，调用swap16()转成大端；如果是Uint32Array就用swap32()
  buffer = buffer.swap16();
  
  await fs.writeFile('output.bin', buffer);
  console.log('转换并写入完成');
}

swapAndWriteFile().catch(err => console.error(err));

注意事项 #

• 单字节类型的Typed Array（比如Uint8Array、Int8Array）不需要转换字节序，因为单个字节不存在端序问题。
• 如果不确定主机字节序，可以用new Uint16Array([0x1234])[0] === 0x1234来判断：如果返回true就是大端，false就是小端。不过你说机器通常不是大端，所以可以直接处理，但加上判断会让代码更健壮。

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