Python 命名规范PEP 8 标准Python 社区最通用的命名规范来自PEP 8Python 增强提案第 8 号下面按不同元素分类说明兼顾规则和实际示例1. 变量 函数 方法小写 下划线规则全部小写单词之间用下划线_分隔蛇形命名法snake_case避免单字符命名除非是循环变量如i/j、临时变量如x/y变量名要见名知意避免拼音 / 无意义字符如a123。示例# 变量 user_name 王二 # 正确小写下划线见名知意 age 25 # 正确简单变量直接小写 userName 李四 # 错误混合大小写这是Java的驼峰法Python不推荐 u 王五 # 错误单字符无意义 # 函数/方法 def calculate_sum(a, b): # 正确小写下划线 return a b def get_user_info(): # 正确动词名词符合语义 return {name: 张三, age: 25}2. 类 异常大驼峰规则每个单词首字母大写无下划线大驼峰命名法PascalCase异常类命名需以Error结尾如ValueError。示例# 普通类 class UserInfo: # 正确大驼峰 def __init__(self, name, age): self.user_name name # 实例变量仍用蛇形 self.user_age age # 异常类 class InputError(Exception): # 正确大驼峰Error结尾 pass3. 常量全大写 下划线规则全部大写单词之间用下划线分隔通常定义在模块顶部代表不可修改的值Python 无真正常量仅靠规范约束。示例MAX_RETRY 3 # 最大重试次数 PI 3.1415926 # 圆周率 DEFAULT_TIMEOUT 10 # 默认超时时间4. 特殊场景命名场景规则示例私有变量 / 方法开头加单个下划线_约定_private_var 10强私有变量 / 方法开头加双下划线__命名改写__strong_private 20魔术方法 / 属性前后双下划线__xx__系统保留__init__、__str__模块 / 包名小写尽量简短无下划线math、requests5. 避坑提醒不要用 Python 关键字命名如if、for、class、def等不要以数字开头如123var错误var123正确命名长度适中太短如x无意义太长如user_name_and_age_and_gender冗余中英文混用优先用英文避免拼音如yonghu不如user易读。总结核心规则变量 / 函数用snake_case小写 下划线类用PascalCase大驼峰常量用UPPER_SNAKE_CASE全大写 下划线约定规则私有元素开头加_魔术方法前后加__模块 / 包名小写简短通用原则见名知意、符合 PEP 8 标准避免关键字和无意义命名。遵循这些规范代码会更符合 Python 社区的习惯也更容易被自己和他人理解、维护。