Ruff 安装与使用指南

Ruff 是现在 Python 生态里很值得默认安装的工具。它把很多 lint 规则和格式化能力放到一个二进制里，速度快，配置也不复杂。

安装

已有 uv 的项目：

1
uv add --dev ruff
2
uv run ruff check .

不使用 uv，也可以直接：

1
pip install ruff
2
ruff check .

uv 的工具模式也很适合偶尔运行：

1
uvx ruff check .

常用命令

1
ruff check .
2
ruff check . --fix
3
ruff format .
4
ruff check src tests

check 负责 lint，format 负责格式化。不要把它们混成一个概念。

配置

pyproject.toml：

1
[tool.ruff]
2
line-length = 100
3
target-version = "py312"
4

5
[tool.ruff.lint]
6
select = ["E", "F", "I", "B"]
7
ignore = []

I 会处理 import 排序，B 来自 flake8-bugbear，能抓一些常见坑。

放进 CI

1
uv run ruff check .
2
uv run ruff format --check .

如果项目还没有完整测试，先把 lint 和格式检查加上也很划算。

常见问题

一上来不要开启所有规则。老项目会被刷屏，最后没人愿意修。建议先开基础规则，新代码保持干净，再慢慢收紧。

如果你还没统一 Python 环境，先看 uv 安装和使用教程 或 pyenv 安装与使用指南。

总结

Ruff 适合作为 Python 项目的默认质量工具。它不替代测试，但能快速挡住未使用变量、导入顺序、明显错误和格式漂移。更多规则参考 Ruff 官方文档。