PEP 8 是 python 官方推荐的代码风格指南,旨在提升代码统一性、可读性与协作效率;涵盖缩进、行宽、空格、命名、导入、空行等细节,并可通过工具自动执行。

PEP 8 是 Python 官方推荐的代码风格指南,不是强制标准,但被绝大多数项目和团队当作默认规范来遵循。它的核心目标是让 Python 代码更统一、更易读、更易协作——就像大家写字都用同一种标点和段落习惯,别人一眼就能看懂你在写什么。
它管哪些事
PEP 8 覆盖的是“怎么写才看着舒服、改着顺手”的细节,主要包括:
- 缩进必须用 4 个空格,禁用 Tab,更不能混用
- 每行最多 79 个字符(注释和文档字符串建议 72 字符)
- 运算符两侧加空格(比如 a = b + c,不是 a=b+c)
- 函数名、变量名用小写+下划线(get_user_id),类名用大驼峰(UserProfile),常量全大写(MAX_RETRY)
- import 语句分三组:标准库 → 第三方库 → 本地模块,每行只导入一个
- 函数/类之间空两行,方法之间空一行,逻辑块之间可空一行
为什么值得重视
它不决定代码能不能跑,但决定别人愿不愿意读、敢不敢改。团队里有人写 def GetUserName(),有人写 def get_user_name(),时间一长,光猜命名就浪费大量精力。PEP 8 就是提前约好“大家按同一个节奏呼吸”。
不用死记,靠工具就行
实际开发中没人手动逐条检查。主流做法是:
立即学习“Python免费学习笔记(深入)”;
- 编辑器配插件:pycharm 按 Ctrl+Alt+L 自动格式化;vs code 装 Black 插件,保存即修正
- 提交前跑检查:用 flake8 扫描风格问题和潜在 bug
- CI 流水线集成:git push 后自动拒收不合规代码
基本上就这些。它不复杂,但容易忽略——尤其刚上手时总想“先跑通再说”,结果等三人协作、十次迭代后,代码就变成只有自己能懂的密语了。