Python编码规范指南，强制执行PEP 8风格、语法验证和单元测试，推荐现代Python 3.10+特性及uv依赖管理工具，提升代码质量与一致性。
说明：
## 核心用法
本技能为Python开发提供全面的编码规范与最佳实践指导，适用于代码编写、审查和重构场景。核心功能包括：
**代码风格管控**：严格执行PEP 8规范，包括4空格缩进、88字符行长限制（Black默认）、导入分组排序（标准库→第三方→本地）、命名约定（snake_case函数/变量、PascalCase类、UPPER_CASE常量）等。
**质量门禁机制**：提交前强制检查清单——通过`py_compile`进行语法验证、自动检测并运行pytest/unittest测试、支持ruff/black格式化检查。确保每次代码提交前基础质量达标。
**现代化版本策略**：明确排斥Python 2及EOL版本（3.9于2025年10月终止支持），最低要求Python 3.10+，推荐3.11-3.13以充分利用match语句、海象运算符、联合类型语法（`|`）等新特性。
**智能依赖管理**：优先检测并使用uv工具（新一代Python包管理器），自动回退至pip，提供`uv init`、`uv pip compile`等现代工作流命令。
**Pythonic模式库**：内置大量惯用法示例，包括列表/字典推导式、上下文管理器、解包操作、EAFP优于LBYL原则、f-字符串格式化、类型提示、dataclass数据类、pathlib路径处理等，同时明确标注反模式（可变默认参数、裸except、全局状态等）。
## 显著优点
1. **标准化程度高**：基于官方PEP 8及社区广泛采纳的Black/ruff工具链，避免团队风格争议
2. **自动化检查**：提供可执行的bash脚本片段，降低人工审查成本
3. **前瞻性版本管理**：主动淘汰EOL版本，引导技术栈升级
4. **工具链现代化**：率先集成uv，响应社区工具演进趋势
5. **模式即代码**：正反示例可直接复制使用，降低学习曲线
## 潜在局限
– **工具依赖假设**：假设环境中已安装ruff/black/pytest，未提供安装指引
– **uv覆盖有限**：uv尚处快速发展期，部分复杂场景（如交叉编译、特定平台wheel）可能需回退pip
– **88字符争议**：Black的88字符与严格PEP 8的79字符并存，可能引发选择困惑
– **无CI/CD集成**：未涉及GitHub Actions、pre-commit hooks等持续集成配置
– **类型提示深度**：仅要求公共函数标注，未强制完整类型覆盖或mypy检查
## 适合人群
– Python初学者建立规范编码习惯
– 团队寻求统一的代码审查基准
– 从旧版本（3.9及以下）迁移至现代Python的项目
– 希望尝试uv替代pip/conda的开发者
## 常规风险
| 风险点 | 说明 |
|——–|——|
执行权限 | 提供的bash脚本需手动复制执行，存在误操作可能 |
| 版本漂移 | 未锁定ruff/black等工具版本，新规则可能破坏既有代码 |
| 测试覆盖盲区 | `2>/dev/null`静默处理测试缺失，可能掩盖未配置测试的问题 |
| uv兼容性 | 部分遗留项目或特定平台可能遇到uv支持问题 |
| 过度简化 | 复杂项目需额外配置（如monorepo、多Python版本矩阵），本技能未涵盖 |
会员专属
