Math.acos()计算角度与安全范围拦截方法

直接使用 Math.acos() 计算角度时，公式本身很少出错，真正的问题在于输入值——它常常会因浮点运算误差而微妙地超出理论上的 [-1, 1] 范围，例如 1.0000000000000002 或 -1.0000000000000004。在几何计算、向量夹角或地理距离等场景中，这类情况非常普遍。因此，关键不在于避开 acos，而是为它增加一道安全护栏。

使用 safeAcos 替代直接调用 Math.acos

最直接有效的方法是定义一个带截断功能的封装函数，将越界的输入值强制限制在有效区间内：

• const safeAcos = x => Math.acos(Math.max(-1, Math.min(1, x)))
• 该函数对合法输入（如 0.8 或 -0.3）保持原样，仅将小于 -1 或大于 1 的值分别截断为 -1 和 1。
• 相比手动编写条件判断，这种写法更简洁、无分支，尤其适用于需要高频调用的计算场景。

明确余弦值来源，避免中间计算放大误差

许多越界问题源于余弦值的计算过程。当它由一系列浮点运算推导得出时，精度损失可能导致结果略微超出范围：

• 例如：const cosTheta = dot(v1, v2) / (len(v1) * len(v2))。数学上结果应在 [-1, 1] 内，但计算机计算结果可能为 1.0000000000000004。
• 最佳实践是：计算出 cosTheta 后，立即交由 safeAcos 处理，而非先判断是否越界。这样逻辑更清晰安全。
• 若需调试观察越界情况，可临时添加检查：if (Math.abs(cosTheta) > 1.000001) console.warn('cosθ out of safe range:', cosTheta)。但在生产环境中，safeAcos 已足够。

对接近 ±1 的情况进行语义优化（可选）

当 cosTheta 极其接近 1（夹角近0度）或 -1（夹角近180度）时，Math.acos 数值上稳定，但有时可从物理意义层面优化：

• 例如：if (cosTheta > 0.999999) return 0。当夹角无限接近0时，直接返回0弧度，可节省函数调用并明确意图。
• 同理：if (cosTheta < -0.999999) return Math.PI。
• 此类优化非必需，但在物理引擎、地理信息系统等需要海量重复计算的场景中，能带来小幅性能提升，并避免数值边界附近的微小抖动。

预防优于错误处理

Math.acos 在遇到越界输入时会返回 NaN，但依赖 isNaN() 事后补救是一种被动且危险的做法：

• NaN 会像病毒一样污染后续所有计算。
• 与其事后检测清理，不如从根源预防。使用 safeAcos 可杜绝 NaN 产生。
• 真正需要严格报错处理的是非数字输入（如 null、undefined 或字符串）。这类数据有效性检查应由上游业务逻辑保证，不属于 safeAcos 的职责范围。