【入门夯实】math.fmod与取余运算的差异：负数取模的符号规则

学员常见误区

取余运算 % 与 math.fmod 看似同物，负数输入时结果不同：Lua 的 % 结果符号跟随除数（结果补到非负），math.fmod 结果符号跟随被除数（保持负号）。学员用 % 做环状索引后传入负数，索引越界报错却找不到原因。错误场景：

print(-7 % 3)
print(math.fmod(-7, 3))

% 输出 2（补到非负），fmod 输出 -1（保持符号）——两个"余数"差了整整一个除数。

正确姿势

需要非负的环状回绕用 %（配合 +1 转下标），需要带符号的数学余数用 fmod。规范写法。示例代码如下：

local function ringIndex(i, n)
    return i % n + 1
end
print(ringIndex(-1, 5))
print(ringIndex(7, 5))

ringIndex(-1, 5) 得 5（负一正确回绕到末位），ringIndex(7, 5) 得 3（超出回绕）——环状索引对任意整数输入都安全。

引擎验证

三步验证：-7 % 3 得 2；math.fmod(-7, 3) 得 -1；正数输入时两者一致（7 % 3 与 fmod(7, 3) 都是 1）——差异只在负数出现，正数场景可互换。

举一反三

math.fmod 对浮点数同样适用，配合 floor 可截取小数的指定位。示例代码如下：

print(math.fmod(7.5, 2))
print(math.floor(7.5 * 10) % 10)

fmod(7.5, 2) 得 1.5，floor 乘十取余得 5（小数点后首位数字）——浮点余数与位截取的组合常见于坐标与进度条计算。