1.1 KiB
1.1 KiB
name, description, type
| name | description | type |
|---|---|---|
| CI/CD 经验 | Python 版本固定、工具版本一致性、Ruff 忽略规则等 CI/CD 相关经验 | reference |
CI/CD 经验
Python 版本固定
- 使用
.python-version文件固定 Python 版本，确保 CI 和本地开发环境一致 - uv 会自动读取
.python-version - 文件格式：单行版本号，如
3.12.13
工具版本一致性
- Server 和 Desktop 的
pyproject.toml必须保持工具版本一致 - 当前统一版本：
- mypy:
>=1.19.1 - ruff:
>=0.15.7 - pytest:
>=9.0.2
- mypy:
- 过于宽松的版本约束（如
ruff>=0.2.0）会导致 CI 检查结果与本地不一致
Ruff 忽略规则分析
| 风险级别 | 规则 | 建议 |
|---|---|---|
| 高 | RUF012 (可变类属性) | 应修复，使用 ClassVar 注解 |
| 高 | ARG001-005 (未使用参数) | Qt signal handler 场景可忽略 |
| 中 | I001 (导入排序) | 风格问题，可忽略 |
| 低 | RUF001 (中文字符) | 中文注释场景合理忽略 |
| 低 | TC001-003 (TYPE_CHECKING) | 仅影响导入优化，可忽略 |
| 低 | UP042, UP046 (类型语法) | Python 3.12 新语法，可忽略 |