Python变量命名需遵循规则并采用最佳实践以提升代码可读性。1. 变量名只能包含字母、数字和下划线,不可数字开头;2. 避免关键字如if、for;3. 区分大小写,_开头有特殊含义;4. 推荐snake_case命名变量函数,PascalCase命名类,UPPER_CASE命名常量;5. 使用有意义名称如user_count而非uc,布尔值可用is_active等形式;6. 避免list等内置名;7. 函数名用动词如save_to_file;8. 局部变量可短但关键变量应清晰。示例中retry_limit比x更明确,整体提升代码维护性。

Python 变量命名看似简单,但遵循正确的规则和最佳实践能让代码更清晰、易读、易于维护。下面介绍 Python 的变量命名规则以及推荐的编程习惯。
基本命名规则
Python 对变量名有一些硬性要求,必须遵守才能通过语法检查:
- 变量名只能包含字母(a-z, A-Z)、数字(0-9)和下划线(_),不能以数字开头
- 不能使用 Python 关键字(如 if、for、class 等)作为变量名
- 变量名区分大小写(age 和 Age 是两个不同的变量)
- 可以使用下划线开头,但有特殊含义(如单下划线表示“内部使用”,双下划线触发名称改写)
合法示例:user_name、count2、_private_var
非法示例:2nd_user(以数字开头)、class(关键字)、user-name(含减号)
命名风格与约定(PEP 8)
Python 官方编码规范 PEP 8 推荐了不同场景下的命名方式,保持一致能提升协作效率:
- 小写下划线(snake_case):用于变量名和函数名,如 total_price、get_user_info
- 首字母大写下划线(PascalCase):用于类名,如 UserData、HttpRequest
- 全大写下划线(UPPER_CASE):用于常量,如 MAX_RETRY、DEFAULT_TIMEOUT
- 避免使用容易混淆的字符,如字母 l(L的小写)、O(零)、I(i的大写)
实用命名建议
好的变量名是自解释的,能让人一眼看懂用途。以下是一些提高可读性的技巧:
立即学习“Python免费学习笔记(深入)”;
- 用有意义的名字代替缩写,比如用 user_count 而不是 uc
- 布尔变量可加 is_、has_、can_ 前缀,如 is_active、has_permission
- 避免使用内置名称,如 list、str、max,防止意外覆盖
- 函数名应体现动作,使用动词或动词短语,如 calculate_tax()、save_to_file()
- 局部变量可适当简短,但关键逻辑中的变量仍需清晰
实际例子对比
差的命名:
x = 5 y = "admin" z = True
改进后:
retry_limit = 5 default_role = "admin" is_debug_mode = True
明显后者更容易理解变量用途,减少注释依赖。
基本上就这些。遵守规则,坚持清晰命名,你的 Python 代码会更专业、更易维护。










