safeAcos 函数通过 Math.max(-1, Math.min(1, x)) 截断输入，确保 Math.acos 输入始终在 [-1, 1] 内，避免浮点误差导致的 NaN；推荐在计算 cosθ 后立即调用，而非事后检测。
直接用 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 - 比手动写
if (x > 1) x = 1; else if (x < -1) x = -1更简洁、无分支、适合高频调用
明确 cosθ 的来源，避免中间计算放大误差
很多越界源于 cosθ 是通过多个浮点运算推导出来的（例如向量点积除以模长乘积）。这类表达式容易因精度损失超出 [-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)
对极接近 ±1 的情况做语义优化（可选）
当 cosTheta ≈ 1（夹角接近 0）或 ≈ -1（夹角接近 π），Math.acos 本身数值稳定，但你可能更关心角度是否“几乎为零”：
- 例如：
if (cosTheta > 0.999999) return 0，跳过 acos 直接返回 0 弧度，省去一次函数调用且语义清晰 - 同理：
if (cosTheta < -0.999999) return Math.PI - 这种优化不是必须，但在大量重复计算（如物理引擎、GIS 网格遍历）中能小幅提升性能并规避边界抖动
错误处理不是重点，预防才是关键
Math.acos 遇到越界会返回 NaN，但你不该依赖 isNaN() 去兜底：
-
NaN一旦产生，会污染后续所有计算（如NaN * 180 / Math.PI还是NaN） - 与其事后检测，不如前置约束——用
safeAcos消灭 NaN 根源 - 真正需要报错的，是输入根本不是数字的情况（如
null、undefined、字符串），那应由上游数据校验负责
