こんにちは！日々のレガシーコードとの格闘、本当にお疲れ様です。
「昔書かれたC言語のコードを修正したいけれど、どこにどんなバグが潜んでいるか怖くて触れない……」
「ポインタの扱いやメモリ管理が古臭く、現代のセキュリティ基準に全く満たしていない……」
そんな絶望的な状況に陥ったとき、皆さんの強力な味方になってくれるのが Clang-Tidy です。
今回は、単なる「コードのあら探しをする静的解析ツール」としての使い方ではなく、Clang-Tidyの「Fix-it（自動修正）機能」をフル活用して、古いC言語コードをごっそりモダンな書き方に自動変換する実践的なテクニックを伝授します。
これをマスターすれば、何万行もあるレガシーコードのリファクタリング工数を絶望的な数から、コーヒーを一杯飲んでいる間に終わるレベルへと劇的に削減できますよ。さあ、一緒に現代的なC言語開発の世界へ足を踏み入れましょう！
—
1. Clang-Tidyとは何か？（なぜ今、自動リファクタリングなのか）
C言語の歴史は長く、それゆえに「書いてはいけない書き方」や「時代遅れのイディオム」がコードベースに深く根を張っています。例えば、C89時代の古い関数宣言、安全性に欠ける文字列操作（`strcpy`など）、不要な型キャストなどです。
手作業でこれらを直そうとすると、人間はどうしても見落としや新たなバグ（タイポなど）を生んでしまいます。
ここで登場するのが Clang（LLVMコンパイラ基盤） をベースにした静的解析・リファクタリングツールである Clang-Tidy です。
Clang-Tidyがもたらす圧倒的なメリット
1. 抽象構文木（AST）レベルの正確な理解: 単なる正規表現による置換ではなく、C言語の文法を完全に理解した上で解析するため、誤爆が極めて少ないです。
2. Fix-it（自動修正）によるコード書き換え: 問題点を指摘するだけでなく、「こう書き直すべき」というパッチを自分で生成し、ソースコードに直接適用できます。
3. プロジェクト全体の一括処理: ビルドシステム（CMakeやJSON Compilation Database）と連携し、大規模なプロジェクト全体を一網打尽にモダン化できます。
—
2. 環境構築と「確実な」基礎セットアップ
まずは、手元の開発環境にClang-Tidyを導入しましょう。ここでは多くのモダンな開発環境で標準となっている環境を想定して解説します。
インストール（Ubuntu / Debian系の場合）
OSのパッケージマネージャーから、LLVM/Clangのツールチェーンを一式インストールします。
LLVMとClang、およびClang-Tidyパッケージのインストール
sudo apt-get update
sudo apt-get install -y clang-tidy clang-tools
インストールが成功したか、バージョンを確認してみましょう。
clang-tidy –version
出力例（お使いの環境により異なります）:
LLVM version 15.0.0
Optimized build.
必須のセットアップ：`.clang-tidy` 設定ファイルの作成
Clang-Tidyをプロジェクトで動かすには、ルートディレクトリに `.clang-tidy` というYAML形式の設定ファイルを置く必要があります。これにより、「どの検査ルール（Checks）を有効にするか」を厳密に制御します。
プロジェクトのルートに `.clang-tidy` を作成し、以下の設定を記述してください。
.clang-tidy
—
有効にするチェッカーの指定（モダン化と安全性向上に特化）
Checks: >
-,
modernize-,
readability-,
bugprone-sizeof-expression,
bugprone-string-init
チェッカーごとの詳細なオプション設定
CheckOptions:
- key: readability-identifier-naming.naming-style
value: camelBack
…
【ここがポイント】
- `Checks: -, modernize-, readability-`: 一度すべてのチェックを無効（`-`）にした上で、`modernize`（モダン化）と `readability`（可読性向上）のカテゴリを全有効化しています。
- これにより、古いC言語の書き方を強制的に最新の作法へと誘導する布陣が完成します。
—
3. HelloWorldで動作確認：自動修正の魔法を体験する
理論はこれくらいにして、実際にレガシーなC言語のコードをClang-Tidyで自動修正してみましょう。
レガシーなテストコードの用意
以下のような、いかにも古いC言語のコード（`legacy.c`）を用意します。型定義の古さや、冗長な記述が含まれています。
// legacy.c
include
// 古いスタイルの関数定義（引数型を括弧の外に書く方式は現代では推奨されません）
int add_values(a, b)
int a;
int b;
{
return a + b;
}
int main(void) {
// 冗長な初期化
int x = 0;
x = add_values(10, 20);
printf(“Result: %d\n”, x);
return 0;
}
ステップ1：まずは「診断（解析）」のみを実行する
ソースコードにどんな問題があるか、Clang-Tidyに診断させてみます。
clang-tidy legacy.c — -fsyntax-only
実行ログ（イメージ）:
1 warning generated.
legacy.c:5:1: warning:function ‘add_values’ with no prototype is deprecated [modernize-use-trailing-return-type]
このように、古い関数宣言に対して警告を出してくれます。
ステップ2：【本命】Fix-itでコードを「自動書き換え」する
ここからがClang-Tidyの真骨頂です。`-fix` オプションを付与することで、警告を検知した瞬間に、ツール側がソースコードを直接書き換えてくれます。
clang-tidy legacy.c -fix — -fsyntax-only
実行後、先ほどの `legacy.c` を確認してみてください。驚くべきことに、以下のようにコードが自動で書き換わっています！
// 自動修正された legacy.c
include
// 現代的なプロトタイプ付きの関数宣言に自動変換された！
int add_values(int a, int b) {
return a + b;
}
int main(void) {
int x = 0;
x = add_values(10, 20);
printf(“Result: %d\n”, x);
return 0;
}
関数定義の引数部分（`int a; int b;`）が、見事に現代的な `int add_values(int a, int b)` へと変貌を遂げました。これが手動ではなく、コマンド一発で安全に行われるのです。
—
4. プロジェクト単位での一括リファクタリング戦略
実際の開発現場では、1つのファイルだけでなく、何百・何千というソースファイルを抱えているはずです。それらを一括でリファクタリングするための実務的なアプローチを解説します。
CMakeプロジェクトと `compile_commands.json` の活用
Clang-Tidyがコードの文脈（インクルードパスやマクロ定義など）を正確に理解するためには、「どのようにコンパイルされるか」の情報が必要です。
CMakeを使っているプロジェクトであれば、以下のコマンドでビルドディレクトリに `compile_commands.json`（JSON Compilation Database）を生成できます。
CMakeの設定時にコンパイルデータベースの生成を指示
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON -B build
これにより、プロジェクトのルート（またはビルドディレクトリ）に `compile_commands.json` が出力されます。Clang-Tidyはこのファイルを自動的に読み込み、プロジェクト全体の構造を把握します。
一括自動リファクタリングを実行するシェルスクリプト
プロジェクト内のすべてのCソースファイルを対象に、一括でClang-Tidyの自動修正をかけるための実践的なワンライナー（またはスクリプト）です。
compile_commands.jsonを利用して、プロジェクト内のCファイルを一括自動修正
run-clang-tidy -p build -fix
(※ `run-clang-tidy` は `clang-tools` パッケージに含まれるPython製の便利スクリプトです)
【実務運用の注意点】
大規模なコードベースに対して初めて `-fix` をかけるときは、必ず Git などのバージョン管理システムで作業ツリーをクリーンにした状態（コミット済み）で行ってください。一括修正後に `git diff` を実行し、意図しない変更が混ざっていないかレビューするプロセスが、プロのエンジニアとしてのマナーです。
—
5. 毎日のコーディングが劇的に楽になる未来へ
今回ご紹介した Clang-Tidy の自動修正（Fix-it）機能をマスターすれば、レガシーコードの近代化に対する心理的ハードルは劇的に下がります。
- 「古い書き方だから直したいけれど、影響範囲が怖くて手を出せない……」という悩みからの解放
- 人的ミス（タイポや構文ミスのし忘れ）をゼロにした高速なリファクタリング
- チーム全体で一貫した「モダンなC言語コーディング規約」の維持
これを毎日のCI/CDパイプラインや、ローカルでのコミット前フック（Git Hooks）に組み込んでおけば、コードの品質は常に高い水準で自動的に保たれるようになります。
「これをマスターすれば、毎日のコーディングが劇的に楽になりますよ」。
レガシーの呪縛から解放された軽やかな開発ライフを、ぜひ今日から始めてみてください！