Ruff

どのようなものか

Ruffは、Rustで書かれた単一のコマンドラインプログラムです。Pythonの
ソースコードをリンターのルール集に照らして検査し、書式を一貫したスタ
イルに整えます。uvとtyを開発する企業Astralが支援しており、日常の作業
は二つのサブコマンドが担います。`ruff
check`がリンター、`ruff
format`がフォーマッターです。Flake8とBlackより10から100倍速いと謳
い、変更のないファイルを再解析しないためのキャッシュを保持します。数
十のプラグインを含むFlake8、Black、isort、pydocstyle、pyupgrade、
autoflakeの代わりにもなれます。

リンターには900を超えるルールが付属し、多くは人気のFlake8プラグイン
をネイティブ実装で書き直したものです。各ルールには、短い接頭辞と3桁
の数字からなるコードがあり、接頭辞は由来を示します。未使用のインポー
トを表すF401はPyflakes、長すぎる行を表すE501はpycodestyleに由来しま
す。設定では、一つずつか接頭辞単位で、コードからルールを選びます。た
とえば`select
i= ["E",		engineer.company	70
"F"]`はEかFで始まるすべてを有効にし、特別なセレクター`ALL`はすべてを
有効にします。修正を備えるルールも多く、実行時の動作を保つための安全
な修正と、動作が変わり得る危険な修正に分かれます。`ruff
check --fix`は、`--unsafe-fixes`も渡さない限り、安全な修正だけを適用
します。

フォーマッターは、Blackをそのまま置き換えられるよう設計されていま
す。DjangoやZulipなどのコードベースでは、99.9%を超える行が同じ結果に
なります。ただし文書は、同じコードに対して両者を交互に使うことは想定
していないと明記しています。Blackと同様、`#
fmt: off`と`# fmt: on`で囲んだ部分は処理しません。

二つの機能は同じ設定を読みます。設定は`[tool.ruff]`として
`pyproject.toml`内に置くか、`ruff.toml`か`.ruff.toml`に置きます。各
Pythonファイルは、それより上にある最も近い設定ファイルを使って検査さ
れ、そのファイル全体が採用されます。近い方が`extend`で親を指定しない
限り、Ruffは上位ディレクトリーの設定を何も統合しません。コマンドライ
ンの指定は、すべての設定ファイルより優先されます。設定を省くと、
Blackと同じ88文字が行の長さとなり、どの設定にもPythonのバージョンが
指定されていなければ、ルールが前提とするバージョンはプロジェクトの
`requires-python`から得ます。

なぜ重要なのか

速度によって、検査を実行できる場所が決まります。作業を中断させるほど
遅いリンターは継続的インテグレーションへ追いやられ、作成者の関心が別
の作業へ移った後に報告します。すぐに答えるリンターなら、変更がまだ記
憶に新しいうちに、エディターやコミットのフックで動かせます。

統合すると、ツール同士の食い違いもなくせます。Flake8とプラグインで検
査し、isortでインポートを並べ、Blackで整形するプロジェクトは、複数の
設定と固定バージョンを整合させなければなりません。Ruffは、設定を一
つ、固定するバージョンを一つ、ルールの番号体系を一つにまとめます。ま
た、自身のフォーマッターと競合するリンターのルールを公開しているた
め、意図して両方を整合させられます。

終了コードによって、ラッパーなしでも品質ゲートにできます。`ruff
check`は、違反がないか、すべて修正できれば0、違反が残れば1、設定やコ
マンドラインが不正か、Ruff自体が失敗すれば2で終了します。ESLintや
Prettierと同じです。`ruff
format
i--check`は、整形が必要なファイルが一つでもあれば1で終了します。ルー		engineer.company	70
iルは、選択されているか、無効かのどちらかです。選択したルールへの違反		engineer.company	70
iが残ると、終了コードは1になります。		engineer.company	70

代償は、誰かが責任を持ってルールを決めなければならないことです。Ruff
自身は、`select`で明示的に列挙して、`extend-select`を積み重ねるのを
避け、EとFから始め、一度に一群ずつ加えるよう勧めています。`ALL`は更
新のたびに新しいルールも有効にするため、慎重に使うよう案内していま
す。

実際の活用例

六つの言語に共通の警告ゼロの基準を設けた作業では、言語ごとに専用のリ
ンターを置き、RuffがPythonを担当しました。すべての診断をエラーとし、
インラインの抑制を禁止したため、Ruffでは`#
noqa`コメントも使えません。Pythonの指摘には、コードで直す以外の対処
を認めませんでした。コミット前とプッシュ前のフックがリンターとテスト
を実行し、コミットができる前に検査します。

記録された2026年10月のツール構成では、このサイトはRuffに、Hugoのビル
ドを補助する22本のスクリプトという、より小さな仕事を任せていました。
クレジットのページも、ソースの正しさを保つ道具にRuffを挙げています。
`pyproject.toml`のルール群は、好みではなく測定で決めています。
2026-10-15に、Ruffの54のルール群をすべてそのスクリプトに実行したとこ
ろ、39群は何も報告しませんでした。そのうち、対象がこのコードに関係す
る群を、最初の11群に加え、選択は33群になりました。セキュリティーのS
群は有効のまま、5ルールをルールコードで指定して除外しています。それ
ぞれの横には、ここで指摘される形が危険な形に似ていても安全である理由
をコメントに書き、同じ群の他のルールは引き続きゲートにしています。曖
昧なUnicode文字を扱うRuff独自の三つのルールも除外しています。このサ
イトは、本物のemダッシュ、enダッシュ、デンマーク語の文字を意図して使
うためです。

pre-commitの設定は、`ruff check`と`ruff format
i--check`を、コミットで変更する`scripts/`以下のPythonファイルに実行し		engineer.company	70
iます。プロジェクトの修正用タスクも、同じ二つのコマンドを、修正を行う		engineer.company	70
i形で実行します。Ruffの隣には型検査器basedpyrightがあり、コメントで役		engineer.company	70
i割の境界を示しています。リンターは、関数の境界を越えて値を追跡しませ		engineer.company	70
iん。型検査器は初回の実行で、Ruffが問題なしとした実際の不具合を二つ見		engineer.company	70
iつけました。		engineer.company	70

問題が起きるところ

Ruffの問題の大半は、Ruffが、書いた人の意図よりも設定を文字どおりに解
釈することで生じます。

触っていないブランチが、更新後に失敗する。
昨日通ったコードが、Ruffの更新で新しい違反を報告します。よくある原因
は、リリースごとに加わるルールをすべて取り込む`select =
["ALL"]`と、固定していないバージョンの組み合わせです。Ruffのバージョ
ンを固定し、更新をレビューするコミットにします。また、`ALL`ではな
く、プロジェクトが必要な群を列挙し、誰かが追加したときにだけ新しい群
が入るようにします。

一つのフォルダーが、プロジェクトの規則に従わなくなる。
ルート設定で禁止した違反がサブディレクトリーで通ったり、チームが無効
にしたルールがそこで発火したりします。そのフォルダーに`ruff.toml`、
または`pyproject.toml`の`[tool.ruff]`テーブルがあり、Ruffが最も近い
ファイルを丸ごと使うため、その下ではルートの設定がすべて適用されなく
なります。そこのファイルに`ruff
check --show-settings`を実行すると、解決した設定のパスを表示します。
入れ子のファイルを削除するか、`extend
i= "../pyproject.toml"`で継承させます。		engineer.company	70

抑制だけが、理由を失っても残る。 正当な理由で付けた`#
noqa`コメントが、コードの変更後には何も隠していなかったり、同じ行の
次の問題を隠したりします。ルールコードを指定しない`#
noqa`は、その行のすべてのルールを黙らせるため、さらに危険です。もう
何も抑制していない`noqa`コメントを報告するRUF100と、具体的なルール
コードを求めるPGH004を選び、`--fix`で不要なものを削除します。次の例
では、後からインポートが使われるようになり、コメントは何も保護してい
ないため、RUF100が報告します。

```python
import json  # noqa: F401

print(json.dumps({"ok": True}))
```

フォーマッターとリンターが食い違う。 `ruff format`でファイルを書き換
えた後、`ruff
check`がその結果を指摘します。末尾のカンマ（COM812）、インデント
（W191、E111）、引用符のスタイル（Q群）など、フォーマッターが決める
ことを取り締まるルールがあるためです。また、フォーマッターは、可能な
範囲でしか指定の行長に折り返さないため、整形後にもE501が発火し得ま
す。`ruff
format`が出す警告を読みます。文書自身が、警告のない実行を両者が整合
しているかの検査としているためです。警告が挙げるルールは除外し、E501
は行を組み直すきっかけとして扱います。

一括修正が動作を変える。 ツリー全体に`ruff check --fix
i--unsafe-fixes`を実行した後、テストが失敗したり、エラーハンドラーが		engineer.company	70
i以前は捕捉したものを捕捉しなくなったりします。危険な修正では、実行時		engineer.company	70
iの動作の変更やコメントの削除が許容されており、文書自身の例も、コード		engineer.company	70
iが送出する例外の種類を変えます。フックやスクリプトでは		engineer.company	70
i`--unsafe-fixes`を使わず、`--select`で一度に一つのルールの危険な修正		engineer.company	70
iを適用して差分を読み、チームが検査してから、そのルールを		engineer.company	70
i`extend-safe-fixes`で安全な修正に昇格させます。		engineer.company	70

参考資料

  * Ruff — 置き換える道具、主張する速度、維持する組織を説明します。

  * Ruffのリンター — ルールの選択と優先順位、安全な修正と危険な修
正、`noqa`コメント、終了コードを説明します。

  * Ruffのフォーマッター — Blackとの互換性と、整形に競合するリンター
のルールを説明します。

  * ルール — 各ルールのコード、由来、修正できるかを確認できます。

  * Ruffの設定 — ファイルの探索、最も近い設定を使う規則、`extend`、
コマンドラインの指定を説明します。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/ruff/	engineer.company	70
