教程 ↗

HEX 转十进制时用 BigInt 保住精度

从一组 HEX 批量转换实例,处理 JavaScript 大整数的精度、补码和异常输入,让结果可以逐行核对。

HEX 与 BigInt 的活字块概念头图

写 HEX 转十进制,很容易先写下一行 parseInt(hex, 16)。拿 FF 试一下,结果是 255,看起来已经做完了。

换一个长一点的值,问题就出来了。

parseInt("20000000000001", 16)
// 9007199254740992

BigInt("0x20000000000001").toString(10)
// "9007199254740993"

同一个输入,两个结果差了 1。放进一串很长的数字里,这个差别很容易看漏。

JavaScript 的 Number 安全整数上限是 9007199254740991,也就是 2 的 53 次方减 1。从 2 的 53 次方开始,可表示整数之间的间隔变成了 2。这里的 9007199254740993 就被舍入成了 9007199254740992。

我拿本地的 HEX 批量转换器试了这组数。顺着输入和结果看下去,还会碰到位宽、符号位和字节顺序,正好一起整理。

从字符串直接进入 BigInt

转换的入口直接保留字符串。核心逻辑可以先写成这样:

function hexToDecimal(input) {
  const hex = input.trim().replace(/^0x/i, "");
  if (!/^[0-9a-f]+$/i.test(hex)) {
    throw new Error("请输入完整的 HEX 整数");
  }
  return BigInt("0x" + hex).toString(10);
}

hexToDecimal("0x20000000000001");
// "9007199254740993"

先检查整段输入,再交给 BigInt 解析,最后用 toString(10) 得到十进制字符串。整个过程把每一位都保留下来。

如果先经过 parseInt 或 Number,再把结果交给 BigInt,传进去的已经是舍入后的值。BigInt 会原样接住那个 9007199254740992。所以这条路径从一开始就用字符串。

64 位模式精确显示 0x20000000000001 和 FFFFFFFFFFFFFFFF 的十进制结果

图 1:64 位模式下,两行输入都保留了完整的十进制结果。

同一个 HEX 的有符号和无符号结果

图里第二行的 FFFFFFFFFFFFFFFF,无符号结果是 18446744073709551615,有符号结果是 -1。

这两个值对应两种解释方式。按无符号整数读,64 个二进制位都参与数值计算;按 64 位补码读,最高位表示负数,完整数值要减去 2 的 64 次方。

换成短一点的 16 位例子更直观:0x8000 的无符号值是 32768,按补码解释就是 32768 - 65536 = -32768。如果选择 32 位,最高位的位置变了,同一个 0x8000 的有符号值仍然是 32768。

工具因此把位宽作为一个明确的选项,并排显示两种十进制结果。看日志或协议字段时,先确认原始字段的位宽和有无符号,再读对应的一列。

把错误留在原来的行里

批量转换时,我希望粘贴进去的每一行都能在结果里找到。合法值正常显示,错误值留在原位,旁边写明原因。

比如在 16 位模式下放入三行:0x8000、0x10000 和 0xG1。第一行得到 32768 和 -32768;第二行是 65536,超过了 16 位无符号范围;第三行包含 G,格式检查会把它标出来。

16 位批量检查保留正常输入、超出范围和含非法字符的三行结果

图 2:一行正常结果,两行错误,输入顺序保持不变。

处理顺序也就定下来了:先查格式,再查位宽范围,通过后才计算有符号值。这样回头核对原始数据时,可以直接按行找问题。

字节顺序单独处理

0x8000 写的是一个数值。协议或文件里的 80 00 则是一串字节,还要看它按什么顺序排列。

以 16 位为例,大端把高位字节放在前面,80 00 读作 0x8000;小端把低位字节放在前面,同样的 80 00 读作 0x0080,也就是 128。

界面里因此分了两种输入方式:Numeric HEX literal 用来粘贴数值,Byte sequence 用来粘贴字节。选择字节输入后,再选 Big-endian 或 Little-endian。数值模式下,字节顺序的选项会置灰。

16 位小端字节输入中 80 00 得到 128 而 00 80 得到 32768 和负 32768

图 3:小端模式下,80 00 和 00 80 的结果。

这版工具先支持 8、16、32、64 位。实际使用时,选好位宽和输入方式,贴入数据后统一检查;改动设置会清掉旧结果,重新计算后才开放 CSV 导出。

导出时继续使用十进制字符串。如果接着用表格软件查看,把大整数所在列按文本导入,后面的核对就能沿用完整数字。

← 返回列表