python中标识符的命名规则和命名规范

在 Python 中，标识符（变量、函数、类、模块等的名称）需要遵循严格的命名规则（必须遵守）和推荐的命名规范（约定俗成）。以下是详细说明：

一、命名规则（强制要求）

1. 字符范围

• 允许字符：字母（A-Z
  /a-z
  ）、数字（0-9
  ）和下划线（_
  ）。
• 不允许：特殊符号（如 $
  , @
  , %
   等）或空格。

2. 开头字符

• 必须以字母或下划线开头，不能以数字开头。
• 错误示例：2user
  、123var
  。

3. 区分大小写

• name
  、Name
   和 NAME
   是三个不同的标识符。

4. 关键字保留字

• 不能使用 Python 的保留关键字（如 if
  、for
  、class
   等）。
• 查看所有关键字：

  import keyword
  print(keyword.kwlist)  # 输出所有保留字
  
  

1. 长度不限
• 理论上不限长度，但需保证可读性。

二、命名规范（约定俗成，PEP8 推荐）

1. 变量/函数名

• 使用小写字母，单词间用下划线分隔（蛇形命名法）。
• 示例：user_name
  、calculate_area()
  。

2. 类名

• 使用首字母大写的驼峰命名法（CamelCase）。
• 示例：MyClass
  、CarEngine
  。

3. 常量名

• 使用全大写字母，单词间用下划线分隔。
• 示例：MAX_LIMIT
  、PI_VALUE
  。

4. 模块/包名

• 使用简短的小写字母，避免下划线（除非必要）。
• 示例：utils
  、data_loader
  。

5. 其他规范

• 避免单字符名称（除非是临时变量，如 i
  、x
  ）。
• 使用有意义的名称（如 user_age
   而非 ua
  ）。
• 避免混淆：l
  （小写 L）、O
  （大写 O）等易混淆字符。

三、代码示例

# 规则示例
user_name = "Alice"    # 合法
# 2name = "Bob"        # 非法（以数字开头）
# class = "Python"     # 非法（使用关键字）

# 规范示例
# 变量和函数（蛇形命名）
def calculate_area(width, height):
    return width * height

# 类（驼峰命名）
class CarEngine:
    def __init__(self, power):
        self.power = power

# 常量（全大写）
MAX_SPEED = 120
PI_VALUE = 3.1415

# 模块/包（小写）
# 文件名：data_utils.py
# 使用：import data_utils

# 实际调用
print(calculate_area(5, 3))  # 输出 15

my_engine = CarEngine(200)
print(my_engine.power)      # 输出 200

print(f"最大速度: {MAX_SPEED}")  # 输出 120

四、常见错误示例

# 错误1：以数字开头
# 2nd_user = "Bob"  # SyntaxError

# 错误2：使用保留字
# def class():       # SyntaxError
#     pass

# 错误3：特殊符号
# user@name = "Alice"  # SyntaxError

# 错误4：无意义名称
x = 10  # 应改为如 user_count

五、总结

• 规则是语法要求，必须遵守，否则代码无法运行。
• 规范是代码可读性和协作的基础，建议严格遵守 PEP8 规范。
• 推荐使用 IDE（如 PyCharm）或工具（如 flake8
  ）自动检查命名规范。