Math.floorMod() 返回 [0, m-1] 内非负余数，解决负数取余越界问题；而 % 运算符对负数返回负余数，易致 ArrayIndexOutOfBoundsException。
在 Java 中，用 Math.floorMod() 计算带负数偏移的循环索引，核心是解决传统取余（%）对负数返回“向零截断”结果的问题——它会导致索引越界或逻辑错位。而 floorMod(a, b) 总返回与模数 b 同号的非负余数（即范围在 [0, b-1]），天然适配循环数组、环形缓冲区、周期性任务调度等场景。
为什么不用 a % b？
Java 的 % 是“余数运算”，不是数学意义的“模运算”。当被除数为负时，结果符号跟随被除数：
-
-1 % 5→-1（不是想要的4） -
-7 % 5→-2（不是想要的3）
直接用这个值作数组下标会抛 ArrayIndexOutOfBoundsException，或导致逻辑错误（比如本该向前绕到末尾，却跳到了非法位置）。
floorMod() 的正确用法
Math.floorMod(int x, int m) 满足：结果 ∈ [0, m-1]，且 x == m * floorDiv(x, m) + floorMod(x, m)。适用于任何整数 x（含负）和正模数 m：
立即学习“Java免费学习笔记（深入）”；
-
Math.floorMod(-1, 5)→4 -
Math.floorMod(-7, 5)→3 -
Math.floorMod(8, 5)→3（正数行为与%一致）
✅ 安全用于数组索引：array[Math.floorMod(index, array.length)]
典型应用场景示例
1. 循环数组索引（如轮播、环形队列）
用户输入偏移量（可正可负），更新当前显示项：
int[] items = {"A", "B", "C", "D", "E"};
int currentIndex = 2; // 当前是 "C"
int offset = -3; // 向前跳 3 位
currentIndex = Math.floorMod(currentIndex + offset, items.length); // → 4 ("E")
2. 周期性时间计算（如每天第 n 小时对应星期几）
今天是星期三（3，设周一=0），求 100 天后是星期几：
int weekday = Math.floorMod(3 + 100, 7); // → 1 → 星期二
3. 负偏移的坐标归一化（如游戏地图无缝滚动）
X 坐标超出左边界（-5），地图宽为 12，需映射到有效区间 [0, 11]：
int mappedX = Math.floorMod(-5, 12); // → 7
注意事项与常见误区
-
m（模数）必须为正整数，否则抛ArithmeticException - 若
m是变量，务必先校验：if (m - 不适用于浮点数——
Math.floorMod()只有int和long重载；浮点场景需手动实现：((x % m) + m) % m（注意精度与大数溢出） - 性能无负担：
floorMod是 JVM 内建优化方法，比手工写((x % m) + m) % m更简洁、安全、易读
只要模数为正，Math.floorMod() 就是最直接、最可靠的负数循环索引归一化工具。
