为何Math.atan()与Math.atan2()返回结果不同？如何正确转换？

我编写了如下函数，通过三个点计算弧度制角度：

function pointsToAngles(x1, y1, x2, y2, cpx, cpy) {
    const r1 = Math.atan((y1 - cpy)/(x1 - cpx));
    const r2 = Math.atan((y2 - cpy)/(x2 - cpx));

    return [r1, r2];
}

我知道Math.atan()的返回范围是-π/2到π/2，而JavaScript的Math.atan2()返回范围是-π到π。于是我尝试将函数改写为使用atan2()的版本：

function pointsToAngles(x1, y1, x2, y2, cpx, cpy) {
    const r1 = Math.atan2((x1 - cpx), (y1 - cpy));
    const r2 = Math.atan2((x2 - cpx), (y2 - cpy));

    return [r1, r2];
}

但改写后的atan2()版本未达到预期，返回结果与atan()版本不同，差异约为π/2。atan()版本运行正常，atan2()版本却有问题，我忽略了什么？如何实现类似atan()但返回范围超过π/2的角度计算？

解答 #

问题根源：参数顺序颠倒 #

你搞反了Math.atan2()的参数顺序！

Math.atan2()的标准参数是**(y差值, x差值)**，而非你写的(x差值, y差值)。原代码中Math.atan((y差)/(x差))完全等价于Math.atan2(y差, x差)，参数顺序颠倒后，相当于计算atan(x差/y差)，这会导致结果与原函数差π/2（数学上atan(a/b) = π/2 - atan(b/a)，非特殊值场景下成立）。

正确的改写版本 #

function pointsToAngles(x1, y1, x2, y2, cpx, cpy) {
    const r1 = Math.atan2(y1 - cpy, x1 - cpx);
    const r2 = Math.atan2(y2 - cpy, x2 - cpx);

    return [r1, r2];
}

为什么这样改可行？ #

• 原Math.atan(y/x)仅能返回-π/2到π/2的角度，无法区分点所在的象限（比如(x正,y负)和(x负,y正)可能得到相同的锐角结果）；而Math.atan2(y, x)会根据x、y的正负判断象限，返回-π到π之间的正确角度，完美解决原函数的象限判断缺陷。
• 原函数中如果x1 - cpx为0，会触发除以0的错误，而atan2()可以直接处理x差值为0的情况（返回π/2或-π/2），鲁棒性更强。

实现跨象限角度计算的方案 #

直接使用上述正确参数顺序的atan2()版本即可，它既保留了原函数“计算中心点(cpx,cpy)到目标点(x,y)的角度”的核心逻辑，又能覆盖所有四个象限的角度范围（-π到π），彻底解决原atan()只能处理两个象限的局限。

内容的提问来源于stack exchange，提问作者Igor Shmukler