Ruff 速查
共 25 条 Ruff 用法，涵盖基础用法、配置、规则码、行内忽略、集成。 支持搜索与分类筛选，点击即可复制。
基础用法
极快的 Python linter + formatter（Rust 实现）。
| 命令 | 说明 |
|---|---|
| 检查当前目录 | |
| 检查并自动修复可修复项 | |
| 格式化代码（兼容 Black 风格） | |
| 只检查格式（CI 用） | |
| 检查单个文件 |
配置
写在 pyproject.toml 或 ruff.toml。
| 命令 | 说明 |
|---|---|
| 行宽等全局设置 | |
| 启用规则集 | |
| 忽略指定规则 | |
| 按文件忽略 | |
| 目标 Python 版本 | |
| 排除目录 |
规则码
常用规则前缀。
| 命令 | 说明 |
|---|---|
| pycodestyle 风格（空白、行宽） | |
| Pyflakes（未使用变量、未定义名） | |
| isort（import 排序） | |
| flake8-bugbear（常见陷阱） | |
| pyupgrade（语法现代化） | |
| bandit（安全检查） |
行内忽略
按需屏蔽。
| 命令 | 说明 |
|---|---|
| 忽略该行所有告警 | |
| 只忽略指定规则 | |
| 文件级忽略 | |
| 配置级忽略 |
集成
流水线与编辑器。
| 命令 | 说明 |
|---|---|
| GitHub Actions 直接标注 | |
| 提交前检查与格式化 | |
| 编辑器集成 | |
| 按规则统计问题数 |
使用说明
Ruff 速查：基础用法、配置、规则码、行内忽略、集成；支持搜索与分类筛选，点击即可复制。
- 按用途点分类：基础用法、配置、规则码、行内忽略、集成。
- 点「命令」列复制到终端或 pyproject.toml。
- ruff check --fix 修 lint，ruff format 管格式（可替代 Black+isort）。
- 规则用 select/ignore 精细开关，误报用 noqa 精准屏蔽。
常见问题
- Ruff 能完全替代 Black / flake8 / isort 吗？
- 多数场景可以：Ruff 覆盖了它们的常用规则并自带格式器，速度极快；少量特殊插件规则可再配合其它工具。
- 怎么渐进式引入？
- 先在 pyproject.toml 里只 select 少量规则集，逐步扩大；用 per-file-ignores 处理历史代码。
- 需要联网吗？
- 不需要，本地可用。