math.Atan2
返回给定数字对的反正切值,以弧度为单位,并依据两个数字的符号确定其所在象限。
这一页解决什么问题
知道一个点的 (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 |
更多排查入口见故障排查。