30-seconds-of-python 精讲：rads_to_degrees 弧度转角度函数

导读

在数学计算、图形学、物理模拟与数据科学场景中，弧度（radian）与角度（degree）的互换是高频基础操作。本文以 30-seconds-of-python 仓库中的 rads-to-degrees.md 片段为核心，讲解其单行核心公式、浮点精度行为、标准库对照方案，并结合仓库内 math 标签下的同类换算片段（如角度转弧度、摄氏转华氏、英里转公里）揭示该系列片段的统一设计风格。读完本文，你将掌握弧度转角度的公式推导、可直接复用的函数实现，以及何时选用标准库 math.degrees() 的工程判断。

一、片段速览：文档与代码

原文档 snippets/rads-to-degrees.md 是一个典型的 30-seconds-of-python 数学片段（YAML front matter 标注 type: snippet、tags: [math]，更新于 2020-11-02），其完整内容如下：

将一个角度从弧度转换为角度（Converts an angle from radians to degrees）。

实现要点只有一条：使用 math.pi 和弧度转角度公式完成换算。

from math import pi

def rads_to_degrees(rad):
  return (rad * 180.0) / pi

示例调用：

from math import pi

rads_to_degrees(pi / 2) # 90.0

整个片段短小精悍，体现了该仓库“30 秒即可读懂并复用”的内容定位——正如 README.md 所描述，这是一个面向日常开发需求的短小 Python 代码片段集合。

二、数学原理：为什么是 rad * 180.0 / pi

弧度的定义是"弧长与半径之比"，因此一个完整圆周的弧长为 2πr，对应弧度数 2π，同时圆周又对应 360 度。由此得到核心换算比例：

360° = 2π rad

两边同时除以 2π，可得：

1 rad = 180 / π 度 ≈ 57.2958°

因此任意角度 rad 的度数换算公式即为 rad * (180 / π)。代码中 (rad * 180.0) / pi 正是这一公式的直接翻译：

• 180.0 写成浮点字面量，确保整个表达式在 Python 3 中必然得到浮点结果（即使 rad 是整数，如 rads_to_degrees(3)）；
• 除以 pi（即 math.pi ≈ 3.141592653589793），完成归一化。

验证文档示例：rads_to_degrees(pi / 2) 中 π/2 是直角的标准弧度表示，代入公式 (π/2) * 180 / π = 90，输出 90.0，与文档注释完全一致。

从源码结构看，作者刻意复用了 math 模块的 pi 常量而非手写 3.14159，这保证了精度直接对齐 IEEE-754 双精度浮点下的 π 值，避免因截断常量引入额外误差。

三、逆运算对照：角度转弧度

同一仓库中提供了严格对称的逆片段 degrees-to-rads.md：

from math import pi

def degrees_to_rads(deg):
  return (deg * pi) / 180.0

示例：

degrees_to_rads(180) # ~3.1416

两段代码互为反函数：rads_to_degrees(degrees_to_rads(x)) 与 x 在数值上近似相等（受浮点舍入影响存在极微小偏差）。在工程中，这两个函数通常成对出现——例如游戏引擎中"以角度配置、以弧度参与三角函数计算"的典型数据流：

angle_deg = 45
angle_rad = degrees_to_rads(angle_deg)
x = math.cos(angle_rad)   # 三角函数只接受弧度

需要提醒的是，math 标准库本身已提供等价能力：math.degrees(rad) 与 math.radians(deg) 正是官方封装。本文片段的差异化价值在于：零依赖且仅需两行，便于嵌入教学示例、微控制器代码或需要"看见公式本身"的场景；而追求标准性、可读性与跨版本稳定性的生产代码，优先使用 math.degrees()。这一点与仓库内其他片段（如 median.md 文档中明确提到 statistics.median() 提供类似功能）的"手写实现 + 标准库对照"风格一脉相承。

四、精度与边界行为

4.1 典型取值结果

弧度输入	计算结果	说明
pi / 2	90.0	直角
pi	180.0	平角
2 * pi	360.0	整周
1	57.29577951308232	1 弧度的度数

由于公式仅涉及一次乘法和一次除法，没有迭代或分支，因此不存在累积误差；唯一的不确定因素是浮点除法带来的约 1 ulp 级舍入，例如 rads_to_degrees(pi) 实际输出 180.0 恰好精确，而 rads_to_degrees(1) 输出 57.29577951308232。

4.2 输入类型与返回类型

• 传入整数（如 rads_to_degrees(3)）：因 180.0 为浮点数，结果自动提升为 float；
• 传入浮点数：直接返回 float；
• 传入负数：公式对负弧度同样成立（负角度表示顺时针方向的旋转），函数不会报错；
• 传入非数值类型（如字符串）：会抛出 TypeError——片段未做显式类型校验，这符合仓库"极简片段"的设计取向，调用方需自行保证输入合法。

若希望函数对"不合理输入"给出更明确的错误，可以参考同为 math 标签的 factorial.md 的做法：其中通过 raise Exception("Number can't be floating point or negative.") 对负数与非整数输入进行显式拦截。对于弧度换算这类定义域为全体实数的纯线性变换，通常无需此类防护。

五、同类换算片段的家族式设计

rads_to_degrees 并非孤例。纵观仓库 snippets/ 目录，存在一整族"单公式单位/标度换算"片段，结构惊人地一致：from 模块 import 常量 → 单行 return 公式 → 调用示例。这恰好对应仓库的 snippet-template.md 模板规范（简述功能 → 要点列表 → 实现代码 → 调用示例）。

代表性成员包括：

片段文件	函数	公式
rads-to-degrees.md	rads_to_degrees(rad)	(rad * 180.0) / pi
degrees-to-rads.md	degrees_to_rads(deg)	(deg * pi) / 180.0
celsius-to-fahrenheit.md	celsius_to_fahrenheit(degrees)	degrees * 1.8 + 32
fahrenheit-to-celsius.md	fahrenheit_to_celsius(degrees)	(degrees - 32) * 5 / 9
km-to-miles.md	km_to_miles(km)	km * 0.621371
miles-to-km.md	miles_to_km(miles)	miles * 1.609344

观察这些片段可以发现共同的工程习惯：

1. 常量优先从标准库导入：弧度换算用 from math import pi，避免魔法数字；
2. 浮点字面量显式化：180.0、1.8 等写法保证整除陷阱（Python 3 已无整数除法隐患，但 2.x 兼容时代遗留的写法在此保留）；
3. 示例选择"整周/直角"这类可心算验证的值：pi / 2 → 90.0、180 → ~3.1416，便于读者立即核对公式是否正确。

六、实战：在一个完整脚本中使用

以下脚本将弧度换算与逆换算、标准库对照整合为一个可运行示例（可在任意 Python 3 环境中直接执行）：

from math import pi, radians, degrees

def rads_to_degrees(rad):
  return (rad * 180.0) / pi

def degrees_to_rads(deg):
  return (deg * pi) / 180.0

# 自实现与标准库对照
for rad in [pi / 2, pi, 2 * pi, 1]:
  mine = rads_to_degrees(rad)
  stdlib = degrees(rad)
  print(f"{rad:>10.6f} rad -> {mine:.10f}° (stdlib: {stdlib:.10f}°)")

# 双向往返验证
x = 123.45
back = rads_to_degrees(degrees_to_rads(x))
print(f"round-trip error: {abs(back - x):.2e}")  # 浮点往返误差通常在 1e-14 量级

运行结果示例（随平台略有 1e-15 量级差异）：

  1.570796 rad -> 90.0000000000° (stdlib: 90.0000000000°)
  3.141593 rad -> 180.0000000000° (stdlib: 180.0000000000°)
  6.283185 rad -> 360.0000000000° (stdlib: 360.0000000000°)
  1.000000 rad -> 57.2957795131° (stdlib: 57.2957795131°)
round-trip error: 3.55e-14

该实验同时验证了两点：自实现与 math.degrees() 结果完全一致；往返换算的误差符合双精度浮点的正常范围，工程上可以忽略。

七、更多阅读与项目背景

• 本片段所在仓库 30-seconds-of-python 是 30 seconds of code 系列的 Python 分支，收录了数百个短小片段，按 math、list、string、date 等标签组织，详见 README.md；
• 想了解片段的撰写规范，可参考 snippet-template.md 与 CONTRIBUTING.md；
• 数学类片段的更多成员包括：最大公约数 gcd.md、最小公倍数 lcm.md、质数判定 is-prime.md、阶乘 factorial.md、汉明距离 hamming-distance.md、幂和 sum-of-powers.md 等，均可与本文的换算思路相互印证；
• 仓库中所有片段遵循 CC-BY-4.0 许可（见 README.md），可在注明出处的前提下放心引用到自己的项目或教学材料中。

总结

rads_to_degrees 是"三十秒读懂、三十秒复用"型片段的典范：它把 1 rad = 180/π 度 的数学事实压缩进一行 (rad * 180.0) / pi，并与仓库中的 degrees_to_rads 构成完整的双向换算工具对。理解其公式来源、浮点行为和与 math.degrees() 的关系后，你既可以在教学、嵌入式或无依赖环境中直接搬运此函数，也能在正式项目中自信地选择标准库实现——这正是 30-seconds-of-python 系列希望传递给读者的"知其然，更知其所以然"。