Python 命名规则（官方规范 + 实战避坑）

Python 命名规则官方规范 实战避坑Python 命名有强制语法规则必须遵守否则报错和PEP 8 官方规范推荐遵守代码更规范我给你整理成最清晰、最实用的版本直接背会就能用。一、强制语法规则不遵守直接报错只能用 3 种字符大小写字母a-z, A-Z、数字0-9、下划线_不能以数字开头❌ 错误1name、2value✅ 正确name1、value2不能是 Python 关键字 / 保留字比如if、else、for、while、def、class、import、True、False、None❌ 错误if 10、class A大小写敏感name和Name是两个完全不同的变量不能有空格和特殊符号❌ 错误my name、user-name、username✅ 正确my_name、userName二、PEP 8 官方命名规范行业标准这是 Python 开发者统一的写法工作中必须遵守否则会被吐槽代码不规范。表格类型命名风格示例变量 / 函数 / 模块 / 包蛇形命名小写 下划线user_name、get_user_info()类大驼峰每个单词首字母大写UserInfo、StudentManager常量全大写 下划线MAX_COUNT、PI私有属性 / 方法开头单下划线_age、_get_password()强私有属性 / 方法开头双下划线__password魔术方法前后双下划线__init__、__str__三、各场景详细用法1. 变量、函数、模块、文件✅小写 下划线分隔蛇形命名python运行# 变量 user_name 张三 age 20 total_price 99.9 # 函数 def get_user_info(): pass # 模块文件.py 文件 user_utils.py order_system.py2. 类名✅大驼峰每个单词首字母大写无下划线python运行class UserInfo: pass class StudentManager: pass3. 常量✅全大写 下划线Python 没有真正的常量只是约定大写不能修改python运行PI 3.14159 MAX_RETRY_COUNT 3 DEFAULT_STATUS success4. 私有成员类内部使用单下划线_提示是私有外部可以访问只是约定双下划线__真正私有外部无法直接访问python运行class User: def __init__(self): self._age 18 # 提示私有 self.__password 123 # 强私有5. 魔术方法✅前后双下划线系统内置方法不要自己定义这种名字python运行def __init__(self): pass def __str__(self): return 对象描述四、最实用的命名口诀好记变量函数全小写下划线来做分隔类名大写驼峰式常量全大写私有前面加下划线强私有加双下划线不用数字开头不用关键字见名知意不写拼音❌xuesheng✅student五、常见错误示例千万别写❌ 数字开头1_name❌ 关键字命名if 10❌ 特殊符号user-name、user name❌ 大小写混用UserName变量 / 函数不能这么写❌ 无意义命名a、b、temp除非临时变量总结语法规则字母、数字、下划线不能数字开头不能用关键字规范写法变量 / 函数user_name类UserInfo常量MAX_COUNT核心原则见名知意 统一风格