用途:本技能用于把 Ruff 集成进开发工作流,包括编辑器配置、pre-commit 钩子与 CI/CD 流水线。若需配置检查规则应改用 ruff-linting,若需配置格式化选项应改用 ruff-formatting。
主要能力与用法: 编辑器(VS Code):安装扩展 code --install-extension charliermarsh.ruff,并在 .vscode/settings.json 中设置默认格式器 charliermarsh.ruff、保存时格式化与 source.fixAll、source.organizeImports 代码操作,可通过 ruff.lint.args 指定 --select=E,F,B,I。 pre-commit:使用 astral-sh/ruff-pre-commit,钩子 id 为 ruff-check(args: [--fix])与 ruff-format;执行 pre-commit install 安装、pre-commit run --all-files 手动运行、pre-commit autoupdate 更新版本。 CI(GitHub Actions):可用 astral-sh/ruff-action@v3 并传 args: 'check --output-format github';也可分开安装 ruff 后分别执行 ruff check --output-format github 与 ruff format --check --diff。 Docker:docker run -v .:/app ghcr.io/astral-sh/ruff:0.14.0-alpine check /app。
配置优先级:命令行参数最高,其次编辑器 LSP 设置、当前目录 ruff.toml、当前目录 pyproject.toml、父目录配置(递归)、用户配置 ~/.config/ruff/ruff.toml,最低为 Ruff 默认值。
常用命令:ruff check --output-format github、ruff format --check --diff、ruff check --fix && ruff format、ruff check --select E、ruff check --output-format json。
最佳实践与限制:编辑器启用保存时格式化并提交 .vscode/settings.json;pre-commit 先执行 ruff-check --fix 再 ruff-format;CI 用 --output-format github 生成 PR 注解并缓存 Ruff、pre-commit 只跑变更文件;团队应将编辑器与 pre-commit 配置纳入版本控制。编辑器配置(Neovim、Zed、Helix)、GitLab/CircleCI/Jenkins、构建系统、LSP 与迁移指南详见 REFERENCE.md。官方收费、价格与效果等其余事实资料暂未提供。