
うちのPython、3つのツールをRuff 1本に。まず `ruff check .` だけ打とう
## 今夜のひとこと
水曜の夜、FastAPIの小さなAPIを触っていて、ふと手が止まった。flake8は入れたっけ、Blackの設定はどこだっけ、importの並びはisort任せだっけ。Pythonを書くたびに道具の名前が3つ出てくる。1本にまとまらないものか、と思った夜だった。
Pythonを書く人は全員、今日の話の対象です。まずやることは1つだけ。`ruff check .` を打ってみることです。
## 要点まとめ
- RuffはAstral製の、Rustで書かれたPythonのリンター兼フォーマッター。flake8・Black・isortの3役を1本でやる。
- まず打つのは `ruff check .`。直せるものは `ruff check --fix .`、整形は `ruff format .`。
- 設定は `pyproject.toml` に数行だけ。型チェックは別物なので、mypyやpyrightの代わりにはならない。
## 1つ目:3つの道具を1本にまとめる
今までPythonの品質管理は分業が当たり前だった。flake8が文法やスタイルの指摘、Blackが整形、isortがimportの並び替え。入れるものが3つ、設定ファイルも3つ、CIで呼ぶ回数も3回。どれか1つが古くなれば、また調べ直しだ。
Ruffはこの3役を1本のバイナリにまとめたツールだ。FastAPIやPydanticといった大きなプロジェクトでも使われている。Rust製で速い、という話はよく聞く。でも僕が大事だと思うのは速さより「数が1つになる」ことだ。覚えるコマンドが1つ、設定ファイルが1つ。道具が減ると、迷う場所も減る。
## 2つ目:まず打つのは `ruff check .` だけ
入れるのは1行だ。
```bash
pip install ruff
```
uvを使っているなら `uv add --dev ruff` でもいい。入れたら、まずこれだけ打つ。
```bash
ruff check .
```
出てきた指摘を、まずは眺めるだけでいい。直せるものだけ直すなら `ruff check --fix .`、整形だけ確認したいときは `ruff format --check .` で、ファイルを書き換えずに差分を見られる。問題なければ `ruff format .` で整形する。Blackと互換性がある作りなので、乗り換えても整形結果はほぼ変わらない。初回は `git diff` で差分を確認してからコミットすればいい。
## 3つ目:設定は `pyproject.toml` に3行だけ
設定は `pyproject.toml` にまとめる。最初はこれだけで十分だ。
```toml
[tool.ruff]
line-length = 88
[tool.ruff.lint]
select = ["E", "F", "I"]
```
`line-length = 88` はBlackと同じ既定の行の長さ。`select` は見るルールの種類で、`E` がエラー系、`F` が未使用の変数やimportなどの指摘、`I` がimportの並び替えだ。最初から全部入れると指摘が多すぎて嫌になるから、3つから始めるのがちょうどいい。
11月5日に書いたLefthookの話とつなげるなら、コミット前に `ruff check` と `ruff format --check` を走らせるのが次の1手だ。書式の話をレビューでしなくて済むようになる。
## 車の世界で言うと…
点検の道具に似ていると思う。ブレーキはこの機械、排気はあの機械、と測る機械がバラバラだと、測り忘れが出る。1台のテスターでまとめて測れれば、忘れる場所がなくなる。道具が1つだと「あれ、入れてなかった」が起きにくい。
## 実務ではこう効く
まず今日やることは3つだけ。
1. `pip install ruff`(uvなら `uv add --dev ruff`)して、`ruff check .` を打つ。
2. 出た指摘を眺めて、直せるものだけ `ruff check --fix .` で直す。
3. `pyproject.toml` に `[tool.ruff]` を3行足して、チームで同じ設定にする。
型チェックはRuffの仕事じゃない。mypyやpyrightとは役割が違うので、型を見たい人はそちらも別に残しておく。リンターとフォーマッターを1本にするだけでも、Pythonの現場はだいぶすっきりすると思う。
## 相棒キャラNibbleの一言
「道具は少ないほうが、迷わないよ。まず1本、打ってみなよ。」
---
## 情報源
- Ruff公式ドキュメント「FAQ」(2026-11-11確認):https://docs.astral.sh/ruff//faq/
- Ruff(PyPI、0.17.2):https://pypi.org/project/ruff/0.17.2/
※2026年11月11日時点の情報です。Ruffの仕様やバージョンは変わるため、公式ドキュメントで確認してください。