JavaScript 的 % 是求余而非取模,导致负数索引错误;应使用 ((i % n) + n) % n 映射到 [0, n) 区间,注意防御 n=0 和浮点索引。

为什么直接用 % 有时会得到负数索引
取模运算在多数语言里(如 JavaScript、Python)对负数的处理不一致,比如 -1 % 5 在 JavaScript 中是 -1,而不是你想要的 4。这会导致数组访问越界或读到错误元素。
根本原因是:JavaScript 的 % 是「求余」而非数学意义上的「取模」;它保留被除数符号,而循环索引需要的是始终落在 [0, length) 区间的非负余数。
- 场景:用户滚动列表、按键切换 tab、实现环形缓冲区时频繁做
i--或i++后取索引 - 错误现象:
arr[-1]→undefined,或arr[5]在长度为 5 的数组中越界 - 关键点:必须把任意整数
i映射到0 ≤ idx
安全取模的通用写法:((i % n) + n) % n
这是最简、跨语言、无分支的修复方案,适用于 JavaScript、Java、C++、Go 等所有支持 % 的语言。
原理是先用 i % n 得到一个范围在 (-n, n) 的值,加 n 拉回正区间,再模一次确保不超 n。
-
i = -1, n = 5→((-1 % 5) + 5) % 5→(-1 + 5) % 5→4 % 5→4 -
i = 7, n = 5→((7 % 5) + 5) % 5→(2 + 5) % 5→7 % 5→2 - 性能影响极小:现代 JS 引擎对这种表达式有很好优化,比
if分支还快
JavaScript 中可封装成一行工具函数
避免每次手写冗长表达式,也防止漏括号出错。
const mod = (i, n) => ((i % n) + n) % n;
使用时直接:arr[mod(i, arr.length)]。注意别写成 mod(i % arr.length)——参数顺序不能错,且必须传真实长度。
- 常见坑:
mod(-1, 0)会报NaN(除零),调用前确保n > 0 - 如果频繁调用且数组长度固定,可预存
len,避免每次读arr.length属性(虽现代引擎已优化,但明确更稳) - 不要用
Math.floor(i / n) * n类推导——浮点误差和负数 floor 行为会让结果不可靠
Python 用户注意:% 本身已是真正取模,但仍有边界情况
Python 的 % 对负数返回非负结果(-1 % 5 == 4),看起来省事。但问题出在「大正数溢出」和「浮点索引误用」上。
-
i是 float(比如从time.time()计算而来)→int(i) % n才安全,否则float % int可能精度丢失 -
i极大(如10**30)时,某些 Python 实现下%运算可能变慢(虽罕见,但环形日志等场景需留意) - 统一风格建议仍用
((i % n) + n) % n:语义清晰、不依赖语言特性、方便团队跨语言协作
实际用的时候,最易忽略的是「长度为 0」的防御,以及把索引变量当成浮点数传入——这两处一出错,不会报异常,只会静默返回错误位置。










