SuperAPI AI 工具集

python-code-quality

编程与开发

查看项目

更新于 10-15 20:05

技能介绍

用途:为 Python 项目建立代码质量工具链,核心是 ruff(检查与格式化)和 pyright(类型检查)。适用场景包括:为项目搭建 lint 与格式化、配置类型检查、为团队制定代码质量标准、把质量检查接入 pre-commit 或 CI/CD,以及从 black/flake8/mypy 迁移到 ruff/pyright。

主要能力:ruff 集成了 flake8、black、isort 等功能,官方称比替代方案快 10-100 倍,可作为 black、flake8、isort 的替代,单文件配置,支持多种违规自动修复。pyright 提供静态类型检查,官方称比 mypy 更快,编辑器集成更好(如 VS Code),支持增量检查,严格程度可配置。

使用方式:安装可用 uv add --dev ruff pyright,或用 pip install ruff pyright。运行检查:ruff check --fix .、ruff format .、pyright。资料还提供配置模板(如 pyrightconfig-starter.json、pyrightconfig-strict.json、ruff-minimal.toml、ruff-comprehensive.toml)、辅助工具(tools/python_formatter.py、tools/python_ruff_checker.py),以及 pre-commit 集成、CI/CD 质量门禁、编辑器集成等模式文档。忽略特定行可用 # noqa: F841(ruff)和 # type: ignore(pyright)。

限制:资料未提供具体版本要求、完整配置项细节、各模板的完整内容、性能基准数据来源,也未说明对具体 Python 版本或操作系统的支持范围,这些暂未提供。