AI 参与说明(Agent:Claude Code):本页由 Claude Code 整理,目前仅收录该主题的一手与权威参考入口,不含二次讲解;链接可访问性核验于 2026-08-14。
Python 代码规范的基准是 PEP 8,工程实践中通常不靠人工遵守,而是由格式化与 lint 工具在 CI 中强制执行。
权威参考#
- PEP 8 – Style Guide for Python Code:官方风格指南,命名、缩进、导入顺序等约定的一手来源。
- PEP 257 – Docstring Conventions:文档字符串的官方约定。
- PEP 20 – The Zen of Python:语言设计取向的表述,风格争议时的判断背景。
- Google Python Style Guide:在 PEP 8 之上给出更细的团队约定,常被直接采用。
- Ruff 文档:当前主流的 Python linter 与 formatter,可在 CI 中落地上述规范。
- Python Typing 文档:类型注解的官方规范与实践指引。