（9943期）Python Coding Guidelines – 现代 Python 代码规范与最佳实践指南

现代 Python 代码规范与最佳实践指南 Python编码规范指南，强制执行PEP 8风格、语法验证和单元测试，推荐现代Python 3.10+特性及uv依赖管理工具，提升代码质量与一致性。 使用说明 核心用法 本技能为Python开发提供全面的编码规范与最佳实践指导，适用于代码编写、审查和重构场景。核心功能包括： 代码风格管控：严格执行PEP 8规范，包括4空格缩进、88字符行长限制（Black默认）、导入分组排序（标准库→第三方→本地）、命名约定（snakecase函数/变量、PascalCase类、UPPERCASE常量）等。 质量门禁机制：提交前强制检查清单——通过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、全局状态等）。 显著优点 标准化程度高：基于官方PEP 8及社区广泛采纳的Black/ruff工具链，避免团队风格争议 自动化检查：提供可执行的bash脚本片段，降低人工审查成本 前瞻性版本管理：主动淘汰EOL版本，引导技术栈升级 工具链现代化：率先集成uv，响应社区工具演进趋势 模式即代码：正反示例可直接复制使用，降低学习曲线 潜在局限 工具依赖假设：假设环境中已安装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版本矩阵），本技能未涵盖 | 原始说明 Python coding guidelines and best practices. Use when writing, reviewing, or refactoring Python code. Enforces PEP 8 style, syntax validation via py_compile, unit test execution, modern Python versions only (no EOL), uv for dependency management when available, and idiomatic Pythonic patterns.