标识符命名规则

← 返回 Python3 基础语法

5.2 标识符命名规则

变量名在 Python 中叫「标识符」，用于给变量、函数、类等起名字。

标识符规则：必须以字母或下划线 _ 开头，后面跟字母、数字、下划线。

不能用数字开头，不能用 Python 关键字，不能包含空格或特殊符号。

区分大小写：name 和 Name 是两个不同的变量。

💡 取有意义的变量名，如 score 比 s 好，user_name 比 n 好。

💡 变量名长度适中，5-20个字符最佳，过长不方便阅读。

💡 不要用单字母作变量名（循环里的 i/j/k 除外）。

💡 避免用中文拼音作变量名，用英文单词更专业。

正确命名示例

以下是符合规范的变量命名方式。

# ========================================
# 示例：正确命名示例
# 说明：这些变量名都符合 Python 规范
# ========================================
name = '小明'           # 普通变量，小写下划线（推荐）
user_age = 10          # 多个词用下划线分隔（snake_case）
score1 = 95            # 数字可以出现在中间或末尾
Score2 = 100           # 大写开头（帕斯卡命名，常用于类名）
_PRIVATE = True        # 单下划线开头，表示「私有」，外部不要直接用
__all__ = ['name']     # 双下划线开头和结尾，Python 特殊用途
print(name, user_age, score1, Score2, _PRIVATE)

驼峰命名对比

Python 社区约定用 snake_case（下划线命名）。

# ========================================
# 示例：驼峰命名对比
# 说明：Python 推荐用下划线分隔（snake_case）
# ========================================
# 蛇形命名（推荐）
user_name = '小红'
max_score = 100
is_valid = True

# 驼峰命名（也可，但 Python 更常用蛇形）
userName = '小明'   # 小驼峰
MaxScore = 100     # 大驼峰
IsValid = True

print(user_name, userName)   # 两个是不同的变量！
print(max_score, MaxScore)   # 区分大小写

⚠️ 常见错误与正确对比

❌ 错误写法

1name = '错误'

✅ 正确写法

name1 = '正确'

📌 变量名不能以数字开头，会报 SyntaxError。

❌ 错误写法

my-var = 10

✅ 正确写法

my_var = 10

📌 中划线 - 不是下划线 _，会报 SyntaxError。

❌ 错误写法

my var = 10

✅ 正确写法

my_var = 10

📌 变量名不能包含空格，会报 SyntaxError。

❌ 错误写法

class = 1

✅ 正确写法

my_class = 1

📌 class 是 Python 关键字，不能用作变量名。

❌ 错误写法

for = 5

✅ 正确写法

item_for = 5

📌 for 是关键字，不能用作变量名。