JS负数取整陷阱：Math.floor与parseInt结果为何不同

图示：Math.floor 与 parseInt 在负数场景下的取整方向与结果分歧

一、现象直击：为什么负数会暴露隐藏的差异

很多开发者在日常编写业务代码时，习惯将 parseInt 当作轻量级的“数字去小数”快捷方法。在只处理正整数（如分页计算、像素值换算、购物车计数）时，这种用法往往能正常工作，因而掩盖了两者在设计目标与运算模型上的本质区别：

// 正数测试：表面上完全一致
console.log(Math.floor(3.2));   // 3
console.log(parseInt(3.2, 10));  // 3

console.log(Math.floor(3.7));   // 3
console.log(parseInt(3.7, 10));  // 3

// 负数测试：结果立刻出现分化
console.log(Math.floor(-3.2));  // -4
console.log(parseInt(-3.2, 10)); // -3

console.log(Math.floor(-3.7));  // -4
console.log(parseInt(-3.7, 10)); // -3

如果将这些数字放置在真实数轴上观察，差异产生的原因便一目了然：正数与负数在“向下”与“去尾”两个维度上的几何走向是不同的。

图 1：正数与负数在数轴上的取整移动轨迹对比

对于正数 3.7 而言，“朝向负无穷大”和“朝向原点 0”都意味着在数轴上向左移动，因此两者重合在整数 3。但对于负数 -3.7 而言：

• 向负无穷大方向（-∞）：数值越小越往左，紧挨着的更小整数是 -4；
• 向原点方向（0）：剥除小数部分相当于向右靠拢，最接近的整数是 -3。

二、底层原理：Math.floor 的数学定义

Math.floor(x) 是 ECMAScript 标准库内置的纯数学函数，其规范定义非常明确：返回小于或等于给定数值的最大整数（Floor Function，数学记作 ⌊x⌋）。

在数学几何定义中，“小于”的判定完全由数轴上的序关系决定：左边的数永远小于右边的数。因此：

• 对于 3.7，满足 整数 ≤ 3.7 的所有候选整数为 [..., 1, 2, 3]，其中最大的整数是 3；
• 对于 -3.7，满足 整数 ≤ -3.7 的所有候选整数为 [..., -6, -5, -4]，其中最大的整数是 -4。

无论小数部分是 .1 还是 .9，Math.floor(-3.1) 与 Math.floor(-3.9) 都会坚定地输出 -4。它保证了取整操作在数学区间上的连续性和单调递增性，非常适合用于离散网格定位、物理引擎碰撞箱和二维坐标平铺。

三、机制剖析：parseInt 的字符解析流水线

与纯数学运算的 Math.floor 完全不同，parseInt(string, radix) 的初衷是从文本中提取整数。当我们将一个浮点数传给 parseInt 时，JavaScript 引擎并不会以纯数值算法去处理它，而是触发了一整套字符转换与流式解析流程。

图 2：parseInt 内部字符流解析机制与 Math.floor 浮点计算流比对

依据 ECMAScript 规范，执行 parseInt(-3.7, 10) 的内部具体步骤如下：

1. 隐式字符串转换：由于 parseInt 第一个参数预期为字符串，数字 -3.7 会先调用抽象操作 ToString(-3.7)，转换为字符序列 "-3.7"。
2. 跳过空白并检测符号：解析器从左向右读取，忽略前导空白字符，匹配到字符 '-'，将其记录为负符号位。
3. 逐位收集合法数字：继续向右读取字符 '3'。在十进制（radix 10）下，'3' 是有效字符，累加入整数缓冲区。
4. 遭遇非法字符并立即停机：解析器读到下一个字符 '.'。由于小数点不是十进制整数的有效组成字符，parseInt 立即停止扫描，直接丢弃小数点及其右侧的所有后续字符。
5. 组装并返回结果：将负号位与缓冲区数字组合，得到最终数字 -3。

可以看出，parseInt 得到 -3 仅仅是因为它在遇到小数点时“中断了解析”，而不是在执行任何数值意义上的取整计算。

// 极其微小的数值
const num = 0.0000005; // 实际字符串表示为 "5e-7"

console.log(Math.floor(num));   // 0 (完全正确)
console.log(parseInt(num, 10));  // 5！(解析到 '5' 遇到 'e' 停止，严重 BUG)

const negNum = -0.0000005; // 实际字符串表示为 "-5e-7"
console.log(Math.floor(negNum));   // -1
console.log(parseInt(negNum, 10));  // -5！(严重失真)

四、横向比对：常见取整方法在负数下的表现全景

在现代 JavaScript 开发中，除了 Math.floor 和 parseInt 之外，还有多个常用的取整 API。弄清楚它们在负数下的差异，能够帮助我们在编写业务逻辑时准确表达意图。

图 3：常见取整函数与操作符在负数场景下的行为特性矩阵

1. Math.trunc（ES6 标准截断方法）

如果你的初衷确实是“丢弃小数部分，只保留整数符号”（向零截断），那么 ES6 引入的 Math.trunc(x) 是最标准、最直接的解决方案。它完全在纯数值层面运行，不存在 parseInt 的字符串转换开销，也不会受到科学计数法的干扰：

Math.trunc(3.7);   // 3
Math.trunc(-3.7);  // -3
Math.trunc(-0.0000005); // -0 (纯数值安全)

2. Math.ceil（向上取整）

Math.ceil(x) 总是向正无穷大方向寻找最小整数。因此对于负数 -3.7，大于等于它的最小整数恰好是 -3。虽然在负数下它的结果与 Math.trunc 一致，但其数学含义是“向上”，而在正数 Math.ceil(3.2) === 4 下表现完全不同。

3. Math.round（四舍五入）

注意 JavaScript 的 Math.round 是“向正无穷大四舍五入”（即加 0.5 后向下取整）。在负数半数边界上容易引起混淆：

Math.round(-3.5);  // -3（向 +∞ 靠拢）
Math.round(-3.51); // -4

4. 位运算符（~~x 与 x | 0）

在底层引擎中，按位非（~~x）或按位或（x | 0）会将操作数转换为 32 位有符号整数（ECMAScript ToInt32 抽象操作），其效果也是丢弃小数位（向零截断）。位运算速度极快，但受限于 32 位表示范围，一旦数值超过 2147483647 或小于 -2147483648，就会发生灾难性的整数溢出与符号翻转。

五、实用建议与选型指南

为了避免在处理包含负数的业务数据（如温差计算、财务变动、地理经纬度偏移）时踩坑，请根据输入源与实际业务语义遵循以下决策树：

图 4：JavaScript 取整方案最佳实践与决策路线