Clippyは、Rust公式が提供するリンターで、コンパイラだけでは検出しきれない慣用句違反や非効率な書き方、潜在的バグを指摘するツールである。2014年頃にAndre Bogus氏（GitHub上ではllogiq）が個人プロジェクトとして開始し、その後Rustの公式ツール群、いわゆるrust-langオーガニゼーション配下に移管された経緯を持つ。現在はrustupでツールチェーンを入れるだけで利用でき、500を超えるルールが整備されている。他言語の単なるスタイル警告と異なり、Rustコンパイラの内部APIに直接アクセスして型情報まで踏まえた指摘を行うため、診断の精度が高いのが特徴となる。
この記事の目次
- Rustコンパイラ内部との一体運用
- ルールカテゴリと厳しさの段階
- 代表的なルールと修正例
- CIへの組み込みとプロジェクト運用
- まとめ
Rustコンパイラ内部との一体運用
Rustコンパイラrustcは、もともとプラグインとしてリンターを追加できる仕組み、すなわちLint APIを内部に持っている。Clippyはこの公式APIに直接乗っかるツールとして実装されており、解析時にはHIR（High-level Intermediate Representation）やMIR（Middle Intermediate Representation）といったコンパイラ内部の中間表現を参照する。そのため「変数Aの実際の型は何か」「このクロージャがキャプチャしているのはどの変数か」といった、コンパイラだけが知り得る情報をルールの判断材料に使える。
結果としてClippyのlintは、テキストパターンを当てるだけの素朴なリンターとは一線を画す精度を持つ。例えば「Option
ルールカテゴリと厳しさの段階
Clippyのルールはカテゴリで整理されている。correctnessは「ほぼ確実にバグである」記述に対する指摘で、規定でerrorレベルに割り当てられる。suspiciousは「文法上は正しいが意味的に怪しい」もの、styleは「Rustらしい書き方からの逸脱」、complexityは「もっと簡潔に書ける」ものを扱う。ここまでが通常運転で、cargo clippyを実行すると既定で有効化されている。
より厳格な指摘がほしい場合は、pedantic、nursery、restrictionといったカテゴリを明示的に有効化できる。pedanticは「人によっては不要に感じるかもしれないが、品質向上に寄与する」厳しめのルール、nurseryは「まだ実験的だが将来昇格する可能性のある」もの、restrictionは「特定状況下のみ有効な制限的ルール」を含む。プロジェクトのCargo.tomlにcargo-features = ["profile-rustflags"]を入れるとともに、lints.clippyセクションで個別ルールを設定する、というのが現代Rustでの一般的な構成法だ。
代表的なルールと修正例
Clippyのルールを眺めると、Rustの慣用句がそのままパターン集として並んでいる。needless_borrowは関数呼び出しに不要な&がついている状況を検知し、削除を提案する。single_matchは「matchの腕が1つしかない」コードを指摘し、if letへの置き換えを促す。redundant_closureは「|x| f(x)」のような単なる委譲クロージャを発見し、fそのものを渡せばよいことを教えてくれる。
これらは単独で見ると些細だが、レビュー時間の節約効果は大きい。Rust初心者は「forループでvec.iter()してcollectする」ような冗長コードを書きがちだが、Clippyを通すと「.map().collect()でよい」「そもそもfilter_mapが使える」といった改善案が一発で出てくる。cargo clippy --fixを使えば、安全に書き換え可能な指摘は自動修正することもでき、リファクタリングの初期段階でClippyに通すだけで多くの慣用句違反が片付く。AST上の慎重な変換に基づいているため、誤った修正が混入しにくいのも安心して使える理由のひとつだ。
CIへの組み込みとプロジェクト運用
RustプロジェクトでのCIは、cargo fmt --checkとcargo clippy --all-targets --all-features -- -D warningsをセットで実行するのが定石になっている。-D warningsは「すべての警告をエラー扱いにする」フラグで、Clippyの指摘が1件でも残っていればビルドを失敗させる強力な歯止めとなる。TokioやServoといった大規模OSSプロジェクトもClippy通過を前提にPRレビューを進めており、Rust界ではClippyに通らないコードは事実上マージできない雰囲気が定着している。
ただし、Clippyはバージョンが上がるたびに新しいルールが追加・既定有効化されるため、ツールチェーンを更新すると突然警告が増えるケースがある。そこでrust-toolchain.tomlでバージョンを固定し、計画的に更新するスタイルが推奨されている。個別のルールが過剰だと感じれば、#[allow(clippy::ルール名)]で局所的に無効化することも可能だ。「公式が出すリンターを、設定で殺し過ぎず、しかし鵜呑みにし過ぎず付き合う」というバランス感覚が、Rustらしい運用の勘所となっている。
まとめ
Clippyは、Rustコンパイラ内部のAPIに直結したRust公式リンターで、500を超えるルールでコードの慣用句違反や潜在バグを丁寧に指摘してくれる。cargo clippy --fixでの自動修正、pedantic以上のカテゴリ追加、CIでのwarning禁止運用など、現代Rustプロジェクトの標準作業に深く根を張った存在となっている。
※本記事はIT用語辞典の手書きドラフトです。公開前に最新情報・出典を確認のうえ加筆修正してください。
コメント