06常量与注释

## 常量（Constant）

常量是指**在程序运行过程中值不应该被修改的量**，通常用于表示固定不变的配置、参数或规则（如数学常数、系统上限值等）。

例如：圆周率π的值（3.14159...）、系统最大连接数（如MAX_CONNECTIONS = 100）、数据库地址（如DB_HOST = "localhost"）等，这些值在程序运行中一般不会变化。

**Python 没有语法层面的 “常量”**（即没有强制限制变量不可修改的机制）。

Python 中所谓的 “常量”，本质上是一种**约定俗成的规范**：通过特定的命名方式，告诉其他开发者 “这个变量的值不应该被修改”。

为了区分常量和普通变量，Python 中常量的命名遵循 **“全大写字母 + 下划线分隔”** 的规则（蛇形大写）：

```python
# 正确的常量命名
PI = 3.1415926  # 圆周率（数学常数）
MAX_RETRY = 3   # 最大重试次数（配置参数）
DB_PORT = 3306  # 数据库端口（固定值）
```

- 命名必须全大写，单词之间用下划线（_）分隔；
- 名称应体现常量的含义（见名知意），避免模糊的缩写；
- 通常定义在模块（.py文件）的顶部，方便集中管理。

**与变量的区别**：变量的值可能在程序中动态变化（如count = 0; count += 1），而常量的值应保持固定。

## 注释（Comment）

注释是代码中**不参与执行的文本**，用于对代码的功能、逻辑、设计思路等进行说明。其核心作用是：

- 帮助自己或他人理解代码（尤其是复杂逻辑）；
- 临时屏蔽一段代码（调试时常用）；
- 记录代码的修改历史、作者信息等。

Python 支持两种常用的注释方式：**单行注释**和**多行注释**。

单行注释（最常用），用**井号（#）** 开头，#后面的内容会被 Python 解释器忽略（不执行）。

```python
# 这是单行注释，单独占一行，用于解释下面的代码
name = "Python"  # 这是行内注释，解释当前行：定义一个名为name的变量

# 计算圆的面积
radius = 5
area = PI * radius **2  # 面积 = π × 半径²（行内注释说明计算公式）

```

注意：#和注释内容之间通常加一个空格，让注释更易读（非强制，但推荐）。

多行注释（文档字符串），当需要写一段较长的注释（如函数功能说明、模块介绍）时，可用**三个单引号（'''）** 或**三个双引号（"""）** 包裹。

多行注释有两种典型用法：

- **普通多行注释**：用于解释代码块（如模块开头说明功能）；
- **文档字符串（docstring）**：专门用于描述函数、类、模块的功能（可被help()函数读取，生成帮助文档）。

普通多行注释（模块说明）

```python
'''
这个模块用于处理用户信息，包括：
1. 验证用户输入的合法性
2. 存储用户数据到数据库
3. 读取用户信息并返回
'''

# 下面是具体代码...
def check_user_input(input_data):
    pass

```

文档字符串（函数说明）

```python
def calculate_area(radius):
    """
    计算圆的面积
    
    参数：
        radius: 圆的半径（必须是正数）
    
    返回：
        float: 圆的面积（π × radius²）
    """
    return PI * radius** 2

# 用help()可以查看文档字符串
help(calculate_area)  # 会输出上面的注释内容

```