pep 8是python社区广泛接受的代码风格规范,非强制但关乎专业性;要求用4空格缩进、snake_case命名变量函数、capwords命名类、upper_snake_case命名常量、合理空行、分组导入、运算符两侧空格。

Python代码风格规范(PEP 8)不是强制标准,但它是Python社区广泛接受的“通用语言”。遵循它,能让代码更易读、易维护、易协作——尤其在团队开发或开源项目中,不遵守PEP 8常被视为不专业。
缩进与空格:用4个空格,别用Tab
PEP 8明确规定:使用4个空格进行缩进,禁止混用Tab和空格。编辑器应设为“将Tab自动转为4空格”。
- 函数定义、条件块、循环体等,统一用4空格缩进
- 行内括号对齐时(如长参数列表),可采用悬挂缩进,首行不写参数,后续每行缩进4空格或与括号对齐
- 避免行尾空格;空行前后也不加空格
命名约定:清晰表达意图,区分用途
变量、函数、类、常量等命名需语义明确,并严格按类型选用风格:
- 小写字母+下划线(snake_case):用于变量名、函数名、方法名(如 user_id, calculate_total)
- 大驼峰(CapWords):用于类名、异常名(如 UserProfile, ValidationError)
- 全大写+下划线(UPPER_SNAKE_CASE):用于模块级常量(如 MAX_RETRY_COUNT, DEFAULT_TIMEOUT)
- 私有成员加单下划线前缀(如 _internal_cache),双下划线仅用于名称改写场景(如 __value),一般避免
空行与换行:提升视觉节奏感
合理使用空行,是让代码呼吸的关键:
立即学习“Python免费学习笔记(深入)”;
- 顶层函数和类定义之间,空两行
- 类内方法之间,空一行
- 逻辑段落间(如初始化、校验、主处理)可酌情空一行,增强可读性
- 每行不超过79字符(注释/文档字符串可放宽至72),超长时优先用括号隐式续行,而非反斜杠
导入与空格:简洁、显式、有序
导入语句应独立成行,按标准库、第三方库、本地库分组,组间空一行:
- 避免通配符导入(from module import *)
- 每个import独占一行(import os、import sys,而非 import os, sys)
- 二元运算符两侧各加一个空格(x = y + z),但括号内紧贴(func(a, b),非 func( a , b ))
PEP 8不是教条,而是共识。工具如 black(自动格式化)、flake8(风格检查)能大幅降低人工负担。真正重要的是:保持一致、尊重协作者、让代码自己说话。








