JavaScript中超出安全整数范围的WEI值如何正确转换为ETH

首先明确换算基准：1 ETH = 10^18 WEI，转换本质是将WEI数值的小数点左移18位，既可以通过ethers库的内置方法正确调用实现，也可以完全不依赖Web3类库用原生JS实现，两种方案都能规避JS大整数精度丢失问题。

问题根因 #

JS的Number类型为双精度浮点数，安全整数上限为Number.MAX_SAFE_INTEGER（值为9007199254740991，约9e15），你需要转换的40000000000000000（4e16）已经超出安全整数范围，直接用Number类型存储会出现精度丢失，后续任何计算都会得到错误结果。
注意：如果已经把大数值WEI赋值为Number类型，再转字符串也无法修复精度，必须从值的源头就用字符串类型存储大WEI值。

方案1：正确调用ethers库方法实现 #

ethers.utils.formatEther原生支持传入字符串格式的WEI值，内部已做高精度处理，不需要额外中间转换步骤，直接传入字符串格式的WEI值即可：

// WEI值直接以字符串形式声明，避免赋值阶段精度丢失
const weiValue = "40000000000000000";
const ethValue = ethers.utils.formatEther(weiValue);
// 运行结果为 "0.04"，符合预期

小数值WEI场景下传Number类型不会出问题，但统一用字符串传参是更稳妥的写法，能覆盖所有取值场景。

方案2：无第三方依赖的原生JS实现 #

完全不依赖Web3、ethers等库，通过字符串操作实现转换，彻底绕开JS Number类型的精度限制：

function weiToEth(weiString) {
  // 校验输入为纯数字字符串
  if (!/^\d+$/.test(weiString)) {
    throw new Error("WEI值必须为无符号纯数字字符串");
  }
  const ETH_DECIMALS = 18;
  // 数值长度不足18位时，在前部补0凑够长度
  const paddedValue = weiString.padStart(ETH_DECIMALS + 1, "0");
  // 拆分整数部分和小数部分
  const integerPart = paddedValue.slice(0, paddedValue.length - ETH_DECIMALS);
  const decimalPart = paddedValue.slice(paddedValue.length - ETH_DECIMALS);
  // 去除小数部分末尾无意义的0，全0则保留一位0
  const trimmedDecimal = decimalPart.replace(/0+$/, "") || "0";
  return `${integerPart}.${trimmedDecimal}`;
}

// 测试用例
console.log(weiToEth("100000")); // 输出 0.0000000000001
console.log(weiToEth("40000000000000000")); // 输出 0.04
console.log(weiToEth("1000000000000000000")); // 输出 1.0

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