Python 开发规范

代码规范

• 遵循 PEP 8 风格指南和命名约定

• 使用类型注解增强代码可读性和类型安全性

• 使用虚拟环境管理依赖：

• 优先使用 venv 或 poetry 进行环境隔离

• 使用 requirements.txt 或 pyproject.toml 记录依赖

• 使用上下文管理器处理资源（如文件操作）

• 优先使用列表推导式、生成器表达式和字典推导式

• 使用 pytest 进行测试，保持高测试覆盖率

• 使用文档字符串（docstrings）记录函数、类和模块

• 遵循面向对象设计原则（SOLID）

• 使用异常处理保证程序健壮性

• 使用 dataclasses 或 pydantic 模型表示数据