math

math.Atan2

返回给定数字对的反正切值,以弧度为单位,并依据两个数字的符号确定其所在象限。

签名
math.Atan2 VALUE VALUE
返回类型
float64

这一页解决什么问题

知道一个点的 (x, y)(或 (邻边, 对边)),想求它相对原点的方向角。单参数的 math.Atan 只能看到比值,分不清第一象限和第三象限;math.Atan2 同时接收两个分量,按它们的符号判定象限,因此结果是完整的 (-π, π] 范围内的角度。

go-html-template
{{ math.Atan2 1 2 }} → 0.4636476090008061

什么时候用,什么时候别用

该用:

  • 已知坐标求方向角(图形、指针、罗盘类计算);
  • 需要正确的象限(atan2 是唯一能给出正确象限的两参数版本)。

别用:

  • 只有比值、且只关心 (-π/2, π/2) → 用 math.Atan;
  • 想把结果转成角度 → 结果本身是弧度,再套 math.ToDegrees。

参数顺序是 VALUE VALUE,惯例为 atan2(y, x)(先纵坐标,后横坐标)。传反了两个参数会得到互补角度。

完整示例:由坐标求方向角

layouts/_partials/atan2-demo.htmlgo-html-template
<p>点 (x=1, y=1):{{ math.ToDegrees (math.Atan2 1 1) }} 度</p>
<p>点 (x=2, y=1):{{ math.Atan2 1 2 }} 弧度,约 {{ math.Round (math.ToDegrees (math.Atan2 1 2)) }} 度</p>
<p>点 (x=-1, y=1):{{ math.ToDegrees (math.Atan2 1 -1) }} 度</p>

Hugo 0.167.0 实测渲染为:

html
<p>点 (x=1, y=1):45 度</p>
<p>点 (x=2, y=1):0.4636476090008061 弧度,约 27 度</p>
<p>点 (x=-1, y=1):135 度</p>

你应当看到什么:第三个例子体现 atan2 的价值——横坐标为负时它给出 135 度(第二象限),而单参数的 atan 1 只会给出 45 度。这就是「依据符号确定象限」的实际含义。

返回值边界(实测)

测量条件:Hugo 0.167.0 extended,单语言站点,Windows。

输入 结果 是否报错
1 2 0.4636476090008061(约 26.57 度) 否
1 1 0.7853981633974483(45 度) 否
1 -1 2.356194490192345(135 度) 否
0 0 上游未说明(数学上无定义) 否
参数个数不对(只给一个) —— 是:参数个数错误
返回类型 float64(弧度,范围 (-π, π]) 否

常见坑

类别 症状 真因 怎么修
没报错但结果不对 角度是互补的(如 45 与 90) 两个参数顺序传反了 按 atan2(y, x) 的顺序传
没报错但结果不对 角度是弧度值 没有换算 套 math.ToDegrees
没报错但结果不对 负数坐标得到的结果不符合直觉 忘了结果范围是 (-π, π] 需要 [0, 2π) 时对负值加 2π
报错看不懂 参数个数错误 只传了一个分量 必须传两个:math.Atan2 $y $x

更多排查入口见故障排查。