一、PEP 8：Python 代码风格的基石
在团队协作和项目维护中，一致的代码风格至关重要。它不仅能提高代码的可读性，还能减少沟通成本，提升开发效率。
PEP 8 是 Python 官方发布的代码风格指南，全称为《Style Guide for Python Code》。它由 Guido van Rossum（Python 创始人）等人制定，目的是统一 Python 代码的编写风格，让不同开发者编写的代码都能保持一致的 " ython 味"。可以通过官方文档 Style Guide for Python Code深入学习 PEP 8 的全部内容，但掌握核心规范足以应对大多数开发场景。
二、工具推荐
遵循代码规范不必全靠人工检查，现代开发工具能帮我们自动处理大部分风格问题
格式化工具
- PyCharm：内置 PEP 8 支持，通过Ctrl+Alt+L（Windows）或Cmd+Opt+L（Mac）可一键格式化代码
- VS Code：安装Python和Black Formatter插件后，可配置保存时自动格式化
静态检查工具
- flake8：集成立即检查代码风格问题和常见错误
- mypy：配合类型注解进行静态类型检查，提前发现潜在问题
推荐工具链：Black + flake8 的组合可以实现自动化检查和格式化，大幅减少人为处理风格问题的精力消耗。同时，合理利用 AI 辅助编程工具（如 通义灵码）也能在编写时就保持规范。
三、命名规范
良好的命名是代码可读性的基础，Python 对不同类型的标识符有明确的命名约定
类型命名规则示例变量 / 函数小写字母，单词间用下划线分隔（snake_case）user_id, get_user_data类名每个单词首字母大写（PascalCase，大驼峰）UserProfile, OrderProcessor常量全大写字母，单词间用下划线分隔MAX_RETRY_COUNT, DEBUG_MODE私有属性 / 方法单下划线开头（表示弱内部使用）_calculate_total特殊方法双下划线开头和结尾（魔术方法）__init__, __str__常用缩写参考
在保证可读性的前提下，合理使用缩写可以简化命名
原词缩写说明Identifierid标识符Messagemsg消息Numbernum数字Lengthlen长度Indexidx索引Valueval值Parameterparam参数Temporarytmp临时Configurationconfig/cfg配置Databasedb数据库提示：缩写应遵循行业惯例，避免自造缩写导致理解困难
四、注释与文档
好的代码需要适当的注释，但注释不应重复代码本身能表达的信息，而应补充代码背后的逻辑和思考。
块注释
用于解释一段代码的整体逻辑
[code]"""计算用户平均消费1. 过滤掉无效订单（金额 |
提升卡
置顶卡
沉默卡
喧嚣卡
变色卡
千斤顶
照妖镜
