如何将超大数字转为字符串/BigInt避免自动舍入（适配智能合约）

问题根源 #

JavaScript的Number类型基于双精度浮点数，仅能精确表示2^53（即9007199254740992）以内的整数。超过这个范围的整数，在赋值为Number类型时就会自动舍入丢失精度，后续任何转换操作都无法恢复原始数值。

正确解决方案 #

要完整保留所有数位，必须从输入阶段避免使用Number类型存储超大整数，直接用以下两种方式处理：

1. 直接使用字符串存储 #

如果你的超大整数一开始就是字符串形式，直接使用即可，无需额外转换：

const numStr = '10000000000000000000010';
console.log(numStr); // 输出 '10000000000000000000010'

2. 使用BigInt类型 #

用BigInt类型存储超大整数，支持任意精度的整数运算，转字符串时也能完整保留数位：

// 方式1：直接用BigInt字面量（末尾加n）
const bigNum = 10000000000000000000010n;
console.log(bigNum.toString()); // 输出 '10000000000000000000010'

// 方式2：从字符串转换为BigInt
const numStr = '10000000000000000000010';
const bigNumFromStr = BigInt(numStr);
console.log(bigNumFromStr.toString()); // 输出 '10000000000000000000010'

封装转换函数（针对合法输入） #

如果需要统一处理字符串或BigInt输入，可封装如下函数：

function convertIntoStringWithoutChangingNumber(input) {
  switch (typeof input) {
    case 'bigint':
      return input.toString();
    case 'string':
      if (/^\d+$/.test(input)) { // 验证是否为纯数字字符串
        return input;
      }
      throw new Error('输入必须是合法的整数字符串');
    default:
      throw new Error('输入仅支持字符串或BigInt类型');
  }
}

// 测试示例
console.log(convertIntoStringWithoutChangingNumber('10000000000000000000020')); // '10000000000000000000020'
console.log(convertIntoStringWithoutChangingNumber(10000000000000000001900n)); // '10000000000000000001900'
console.log(convertIntoStringWithoutChangingNumber('10100000000000000000000')); // '10100000000000000000000'

关键注意事项 #

• 绝对不要用Number类型存储超过2^53的整数：一旦赋值为Number，数值已经被舍入，无法恢复原始数位。比如let a = 10000000000000000000010; 此时a的值已经是10000000000000000000000，后续任何转换都得不到原始值。
• 发送至智能合约时，直接传递字符串或BigInt即可（多数Web3库支持这两种类型作为参数）。

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