什么是PEP 8？你平时如何遵守代码规范？

PEP 8 是 Python 官方推荐的风格指南，定义了一套编写 Python 代码的规范，核心原则包括可读性优先、一致性与显式优于隐式，旨在通过命名规范、代码格式等细节提升代码质量。

• 可读性优先：代码主要供人阅读，其次才是机器执行。例如，推荐使用有意义的变量名（如 user_age 而非 a），限制每行代码长度不超过 79 字符以避免横向滚动，在运算符两侧添加空格（如 x = 1 + 2 而非 x=1+2）。
• 一致性：无论是项目内部还是整个 Python 生态，遵循相似风格可降低“认知摩擦”。例如，变量名统一使用 snake_case（如 calculate_total），类名统一使用 CamelCase（如 UserProfile）。
• 显式优于隐式：鼓励明确表达意图，减少猜测。例如，避免使用隐式类型转换或模糊的逻辑判断。

日常遵守代码规范的实践包括：

• 命名规范：变量名、函数名使用 snake_case（如 get_user_data），类名使用 CamelCase（如 DataProcessor），常量使用全大写加下划线（如 MAX_RETRIES）。
• 代码格式：每行代码不超过 79 字符，缩进使用 4 个空格而非制表符，运算符两侧添加空格，避免多余空行。
• 工具辅助：

  Black：自动格式化代码，强制符合 PEP 8 风格（如统一括号对齐、空格使用）。

  isort：自动整理导入语句，按字母顺序排列并分组（如标准库、第三方库、本地模块）。

  Flake8：静态检查工具，提示未遵循规范的代码（如行长超限、命名错误）。

  VS Code 插件：集成 Pylance 或 Pyright，实时提示语法和风格问题。

• 团队协作：

  代码审查：通过同行评审发现逻辑错误和风格问题（如复杂列表推导式可读性差时建议改用 for 循环）。

  CI/CD 集成：在预提交钩子（pre-commit hook）中运行 Black 和 isort，防止不规范代码进入版本库。

  团队约定：共同制定并执行规范，例如约定文档字符串格式（如 Google 风格）。

除 PEP 8 外，值得关注的 Python 代码规范包括：

• Google Python Style Guide：扩展 PEP 8，对文档字符串（推荐 reStructuredText 格式）、导入顺序、异常处理等提出更详细要求，适用于大型项目。
• 文档字符串规范：

  Sphinx/Numpy/Google 风格：规范函数、类、模块的文档说明（如参数、返回值、异常），便于自动生成 API 文档。

  Google 风格：简洁且工具支持良好，例如：def calculate_sum(a: int, b: int) -> int: """Calculates the sum of two numbers. Args: a: First number. b: Second number. Returns: The sum of a and b. """ return a + b

• 框架特定惯例：

  Django：约定模型、视图、模板的命名和组织方式（如模型类名使用单数形式 User 而非 Users）。

  FastAPI/Flask：路由和依赖注入的写法（如 FastAPI 推荐使用 @app.get 装饰器定义路由）。

  学习方式：通过阅读框架文档、社区讨论和优秀开源项目代码掌握这些“软性”规范。

总结：PEP 8 是 Python 代码规范的基础，通过可读性、一致性和显式性原则提升代码质量。结合工具（如 Black、isort）、团队协作（代码审查、CI/CD）和扩展规范（Google 风格指南、框架惯例），可高效落地并超越规则本身，实现更清晰、易维护的代码。