在 Python 中，**定义一个变量来接受圆的半径**，本质是： ✅ 声明一个变量名（如 `r`, `radius`） ✅ 将一个**数值**（通常是 `int` 或 `float`）赋值给它 ✅ （可选但强烈推荐）添加类型提示和文档说明，提升可读性与安全性 下面分 **5 种典型场景** 给出完整、规范、可直接运行的代码示例： --- ### ✅ 场景 1：直接赋值（最简单） ```python # 定义半径变量（整数） radius = 5 # 或浮点数（更通用，因半径常为小数） radius = 3.14159 # ✅ 验证类型 print(f"radius = {radius}, type: {type(radius)}") # 输出：radius = 3.14159, type: <class 'float'> ``` > 💡 提示：Python 是动态类型语言，无需声明“这是 float”，但**语义上半径应为非负实数**。 --- ### ✅ 场景 2：用户输入（交互式获取） ```python # 安全地从用户输入获取半径（带错误处理） try: radius = float(input("请输入圆的半径: ")) if radius < 0: raise ValueError("半径不能为负数！") except ValueError as e: print(f"输入错误：{e}") radius = 0.0 # 设默认值 ``` > ⚠️ 关键点： > - `input()` 返回字符串 → 必须用 `float()` 转换 > - 必须检查 `radius >= 0`（数学上半径 ≥ 0） > - 用 `try/except` 防止用户输 `"abc"` 导致程序崩溃 --- ### ✅ 场景 3：带类型提示（Python 3.6+，推荐用于函数/大型项目） ```python from typing import Union # 方式①：基础类型提示（明确期望数值） radius: float = 4.5 # 方式②：支持 int 或 float（更灵活） radius: Union[int, float] = 7 # ✅ 更现代写法（Python 3.10+）： radius: int | float = 7.0 ``` > 🌟 类型提示不会运行时强制，但能被 IDE（如 PyCharm、VS Code）和类型检查工具（如 `mypy`）识别，提前发现错误。 --- ### ✅ 场景 4：封装为函数参数（最工程化、可复用） ```python import math def circle_area(radius: float) -> float: """计算圆的面积：A = π × r²""" if radius < 0: raise ValueError("半径不能为负数") return math.pi * radius ** 2 def circle_circumference(radius: float) -> float: """计算圆的周长：C = 2π × r""" if radius < 0: raise ValueError("半径不能为负数") return 2 * math.pi * radius # ✅ 使用：定义 radius 变量，再传入函数 r = 2.5 area = circle_area(r) circum = circle_circumference(r) print(f"半径 {r} 的圆：面积={area:.2f}，周长={circum:.2f}") # 输出：半径 2.5 的圆：面积=19.63，周长=15.71 ``` > ✅ 优势： > - 半径校验集中在一个地方（DRY 原则） > - 函数可被多次调用，`r` 可随时重赋值 > - 类型提示 + 文档字符串（docstring）让代码自解释 --- ### ✅ 场景 5：使用 `@dataclass` 或 `NamedTuple`（适合多属性建模） ```python from dataclasses import dataclass from typing import NewType # ✅ 方法①：用 dataclass（可变，带默认值） @dataclass class Circle: radius: float = 1.0 # 默认单位圆 def __post_init__(self): if self.radius < 0: raise ValueError("半径不能为负数") # 使用 c1 = Circle(3.0) # ✅ 自动校验 c2 = Circle() # ✅ 使用默认值 1.0 # ✅ 方法②：用 NewType（创建专属类型，增强语义） Radius = NewType('Radius', float) def area_from_radius(r: Radius) -> float: return 3.14159 * r ** 2 # 创建 Radius 类型变量（需显式转换，强化意图） r: Radius = Radius(2.5) # ✅ 显式标注“这是半径”，不是普通 float print(area_from_radius(r)) # 19.6349375 ``` > 💡 `NewType` 不增加运行时开销，但能让类型检查器（如 mypy）区分 `Radius` 和普通 `float`，避免误传温度、长度等其他 float 值。 --- ### ⚠️ 重要原则（必须遵守） | 原则 | 说明 | ✅ 正确示例 | ❌ 错误示例 | |------|------|-------------|--------------| | **非负性** | 半径数学定义 ≥ 0 | `radius = 0`（允许，表示退化为点） | `radius = -2`（非法） | | **命名清晰** | 用 `radius` 比 `r` 更易懂（除非在极简公式推导中） | `area = math.pi * radius ** 2` | `a = pi * r**2`（可读性差） | | **避免魔法数字** | 不要直接写 `3.14159`，用 `math.pi` | `import math; ... * math.pi` | `... * 3.1415926535`（难维护、易错） | | **防御性编程** | 对外部输入（文件、网络、用户）必须校验 | `if radius < 0: raise ...` | 直接 `math.sqrt(radius)`（可能报错但不明确） | --- ### ✅ 一行总结（可直接抄走） ```python # ✅ 推荐：简洁、安全、可读、符合 Python 习惯 radius: float = float(input("请输入半径: ")) # 用户输入 assert radius >= 0, "半径不能为负数" # 简单断言（调试用） # 后续计算：area = math.pi * radius ** 2 ``` ---