如何将JavaScript数字转换为长度为8的Uint8Array？

JavaScript 标准库目前没有提供安全整数和8字节Uint8Array的直接互转能力，通过位运算手动拆分、拼接数值即可实现，全环境兼容，不存在BigInt64Array的浏览器支持问题。

实现逻辑 #

JavaScript 最大安全整数为2^53 - 1，总共53位有效位，拆分为高21位+低32位两部分即可完整存入8字节长度的Uint8Array，全程不会丢失精度。

完整实现代码 #

function numToUint8Array(num) {
  if (!Number.isSafeInteger(num)) {
    throw new RangeError('输入值必须为JavaScript安全整数，取值范围为 -(2^53 - 1) 到 2^53 - 1');
  }
  const arr = new Uint8Array(8);
  const isNegative = num < 0;
  const absNum = isNegative ? -num : num;
  // 拆分低32位、高21位
  const low32 = absNum % 2 ** 32;
  const high21 = (absNum - low32) / 2 ** 32;
  // 大端序写入：第0位存符号，1-3位存高21位，4-7位存低32位
  arr[0] = isNegative ? 1 : 0;
  arr[1] = (high21 >> 16) & 0xff;
  arr[2] = (high21 >> 8) & 0xff;
  arr[3] = high21 & 0xff;
  arr[4] = (low32 >> 24) & 0xff;
  arr[5] = (low32 >> 16) & 0xff;
  arr[6] = (low32 >> 8) & 0xff;
  arr[7] = low32 & 0xff;
  return arr;
}

function uint8ArrayToNum(arr) {
  if (arr.length !== 8) {
    throw new RangeError('输入必须是长度为8的Uint8Array');
  }
  const isNegative = arr[0] === 1;
  // 拼接高21位、低32位，低32位用无符号右移避免符号位干扰
  const high21 = (arr[1] << 16) | (arr[2] << 8) | arr[3];
  const low32 = (arr[4] << 24 | arr[5] << 16 | arr[6] << 8 | arr[7]) >>> 0;
  const res = high21 * 2 ** 32 + low32;
  return isNegative ? -res : res;
}

效果验证 #

// 基础用例测试
const foo = numToUint8Array(9458239048);
const bar = uint8ArrayToNum(foo);
console.log(bar); // 输出9458239048，符合预期

// 边界值测试
console.log(uint8ArrayToNum(numToUint8Array(2**53 - 1)) === 2**53 - 1); // true
console.log(uint8ArrayToNum(numToUint8Array(-(2**53 - 1))) === -(2**53 - 1)); // true
console.log(uint8ArrayToNum(numToUint8Array(0)) === 0); // true

注意事项 #

• 实现默认采用大端序（网络字节序），是跨设备网络传输的通用标准，可避免x86、ARM等不同架构设备字节序不一致导致的解析错误。如果通信双方约定使用小端序，仅需要倒序调整字节写入位置，核心的高低位拆分逻辑无需改动。
• 代码内置了类型和范围校验，传入非安全整数、长度不符的Uint8Array时会直接抛出错误，从根源避免隐式精度丢失问题。
• 如果业务场景仅需处理非负整数，可以移除符号位相关逻辑，将高21位存入数组前3个字节，可腾出1位冗余存储空间。

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