浮点数接近整数时,为什么余弦门函数会误判
用可复现实例对照 floor(abs(cos(πx))) 与 Number.isInteger,理解 JavaScript Number 解析、舍入和安全整数边界。

Math.floor(Math.abs(Math.cos(Math.PI * x))) 有一种很漂亮的直觉:在精确实数里,整数处的 cos(πx) 是 1 或 -1,取绝对值再向下取整得到 1;非整数处的绝对值小于 1,结果是 0。把它带进 JavaScript 后,关键问题变成了另一个:x、Math.PI 和余弦结果都已经是 binary64 浮点数。一个接近整数的输入可能让这个门函数给出 1,而 Number.isInteger 仍然是 false。
浮点整数判定对照工具把这两个结果放在同一页。它只接受有限的普通十进制输入,在浏览器内把输入解析为一个 JavaScript Number,再并列显示余弦门函数、Number.isInteger、安全整数状态和解析后的数值显示是否偏离原输入。这里用同一组可运行样例拆开这件事。
从一个实数技巧到六个可复现输入
这个构造来自 Artemii Karapetian 的 High School Calculator Computes Analytical Number Theory;讨论入口在 Hacker News。原文把
Z(x) = floor(abs(cos(π × x)))
作为计算器上的整数门函数,再把它嵌进整除与求和构造。原文后续还分别限制了候选范围:素数定义部分从 2 开始,给第 n 个素数选上界的公式也有 n ≥ 6 之类的条件。它展示的是在受限计算器里重新搭出条件门的过程,并没有给 JavaScript 提供一个通用的整数 API 或素数生成器。
我在 Node v26 用下面六个数运行了同一个表达式和 Number.isInteger。完整可运行文件可直接下载。
const gate = x => Math.floor(Math.abs(Math.cos(Math.PI * x)));
for (const x of [1, 1.000000001, 1.00000001, 0.5, 2, 9]) {
console.log(x, gate(x), Number.isInteger(x));
}
| 输入 | floor(abs(cos(π × x))) | Number.isInteger(x) |
|---|---|---|
1 | 1 | true |
1.000000001 | 1 | false |
1.00000001 | 0 | false |
0.5 | 0 | false |
2 | 1 | true |
9 | 1 | true |
1.000000001 是这一页最有用的反例。它不是整数,Number.isInteger 也如实返回 false,但该环境里的余弦门函数返回 1。再往外挪一个数量级到 1.00000001,门函数又回到 0。这种跳变不是一个可以用固定容差补救的整数定义;它取决于输入、π 的近似值、乘法和三角函数实现沿途的舍入。
这张图刻意把“十进制文本”和“解析后的 Number”分开。门函数与标准 API 比较的都不是纸面上的实数,而是同一个已经落在 binary64 格点上的值。
1.000000001 为什么会被门函数放过
在实数模型中,整数与非整数之间的结论来自余弦的精确取值。JavaScript 没有把那个实数模型直接搬进运行时。文本 1.000000001 先变成最接近的 binary64 值,Math.PI 也只是一个 binary64 近似;随后 Math.PI * x 和 Math.cos(...) 都会继续舍入。本机 Node v26 的这一次计算中,Math.abs(Math.cos(Math.PI * 1.000000001)) 显示为 1,于是 Math.floor(...) 给出 1。
这不表示这个输入在数学意义上已经是整数,也不应把它归结成某个“允许误差”的整数测试。三角函数尤其容易把很小的差异压到峰值附近,最后再由 floor 把 0.999… 与 1 分到完全不同的两边。不同引擎对极低位的实现细节可能不同,因此反例的目的不是承诺所有运行时都给同一小数,而是展示为什么这个公式不能承担程序里的整数判定职责。
工具的英文界面从这个反例起步:左侧保留公式的输出,右侧显示标准 API 的结果,并把原始十进制和值的安全范围放在上方。

输入改变时,旧结果会马上隐藏,避免把新文本和上一次的对照混在一起。预置按钮包含这六个复现值;复制按钮只复制当前页生成的文本。
解析后的整数,和原字符串里的整数,不是同一件事
Number.isInteger 的职责很明确:判断一个已经存在的 JavaScript Number 是否没有小数部分。它不会回看输入来自 JSON、表单还是源代码字面量,也不会恢复在解析时已经丢失的十进制位。安全整数边界 Number.MAX_SAFE_INTEGER 是 9007199254740991,超过它以后,相邻整数不再都能被 binary64 区分。
const source = '9007199254740993';
const value = Number(source);
console.log(value); // 9007199254740992
console.log(Number.isInteger(value)); // true
console.log(Number.isSafeInteger(value)); // false
这里的 true 是对 9007199254740992 这个已解析值的正确回答;它不能证明原始字符串仍然代表同一个整数。工具会把“原始十进制”和“解析后的 Number”并排显示。只有两者的规范化十进制显示不同,它才标记“解析后可见改写”;例如上面的 9007199254740993 → 9007199254740992。有些十进制文本显示不变,内部仍然是 binary64 近似值,所以显示相同也不是任意精度证明。
这也是工具拒绝 1e-9、0x10、1,000、NaN、Infinity、单位和表达式的原因。它接受可选负号、数字和一个小数点组成的普通十进制,最多 80 个字符。每个合法文本只有一种解析路径;页面不会执行输入,也不会把它当作任意精度数来处理。
在代码里怎样选择判定
如果变量已经是 JavaScript Number,且业务语义就是“这个当前值有没有小数部分”,直接使用 Number.isInteger(value)。需要把数组下标、精确计数、ID 或相邻整数运算交给这个值时,再加上 Number.isSafeInteger(value)。具体业务范围仍需另核:Number.isSafeInteger 也会接受负整数,因此它本身不是“可用数组下标”的校验器。这两个 API 的边界和语言本身的数值模型一致,也比用三角函数绕一圈更容易让维护者看懂。
如果任务从一串十进制数字开始,并且每一位都必须保留,就不要先把它缩进 Number。保留原始文本并用适合该范围的整数表示来处理;页面上的对照工具故意不提供任意精度承诺。余弦门函数仍然值得观察:它把“在某个点精确为 1、其他点小于 1”的门控想法露了出来,但它适合解释原构造,不适合替代程序的整数检查。
这项工具没有后端、云函数或第三方代算。输入、解析值、结果和复制文本都留在当前浏览器;它们不被上传,也不作为页面统计字段。站点访问和导航可按站点现有规则记录,和工具的数值内容是两条不同路径。
打开浮点整数判定对照工具后,先按“近整数反例”,再按“稍远的非整数”。两个结果之间的变化比抽象地记住“浮点有误差”更容易检查,也能让后续代码选择有明确依据。