代码规范

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 文档：类型注解的官方规范与实践指引。