如何实现BigInt大无符号整数与256bit定长Base64的双向编解码

转换全程不需要引入第三方依赖，核心要求是严格保证二进制段固定为32字节（即256bit），补零操作必须在字节数组的高位端完成，避免数值偏移。

基础规则 #

• 256bit定长二进制对应固定32字节长度，BigInt转字节数组后如果长度不足32，必须在数组头部（数值高位方向）补0x00凑满长度
• 字节序统一使用大端序（高位字节在前），避免跨环境解码出现数值错乱
• 采用标准Base64编码规则，32字节固定长度转出来的Base64字符串长度固定为44位（含末尾1个padding等号）

编码逻辑（BigInt → 256bit二进制 → Base64） #

执行步骤：

• 校验输入为非负BigInt，且数值小于2^256，避免超出长度范围
• 将BigInt逐字节拆解为大端序字节数组
• 字节数组长度不足32时，在头部补零凑满32字节
• 将固定长度的二进制数据转为标准Base64字符串
  JavaScript/TypeScript 环境实现代码：

function bigintTo256BitBase64(bigintVal) {
  if (bigintVal < 0n) throw new Error('仅支持无符号非负整数');
  if (bigintVal >= 1n << 256n) throw new Error('数值超出256bit无符号整数可表示范围');

  const bytes = [];
  let temp = bigintVal;
  // 逐字节取低8位，按大端序存入数组
  while (temp > 0n) {
    bytes.unshift(Number(temp & 0xffn));
    temp >>= 8n;
  }
  // 高位补零，凑满32字节
  const fixedBytes = new Uint8Array(32);
  fixedBytes.set(bytes, 32 - bytes.length);
  // 二进制转Base64：浏览器环境用btoa，Node.js环境可替换为Buffer.from(fixedBytes).toString('base64')
  const binaryStr = String.fromCharCode(...fixedBytes);
  return btoa(binaryStr);
}

解码逻辑（Base64 → 256bit二进制 → BigInt） #

执行步骤：

• 将Base64字符串解码回原始二进制数据，校验数据长度为32字节
• 遍历字节数组按大端序逐字节拼接为BigInt，开头的前导零不会影响最终数值结果
  对应实现代码：

function base64To256BitBigint(base64Str) {
  // Base64解码：浏览器环境用atob，Node.js环境可替换为Buffer.from(base64Str, 'base64')
  const binaryStr = atob(base64Str);
  if (binaryStr.length !== 32) throw new Error('输入Base64字符串不匹配256bit长度要求');
  const bytes = Uint8Array.from(binaryStr, char => char.charCodeAt(0));
  // 逐字节拼接回BigInt
  let result = 0n;
  for (const byte of bytes) {
    result = (result << 8n) | BigInt(byte);
  }
  return result;
}

功能验证 #

// 测试用例
const testValue = 98765432109876543210987654321098765432n;
const encoded = bigintTo256BitBase64(testValue);
const decoded = base64To256BitBigint(encoded);
console.log(decoded === testValue); // 恒定输出true

Node.js环境下替换掉btoa/atob为Buffer相关方法即可直接运行，两种实现的编码结果完全兼容，可以跨环境互转。

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