レガシーコードを「手作業」で直すのは今日で終わり。IntelliJ IDEA「構造検索と置換」でコードの質を劇的に高める方法
こんにちは。現場で長年コードを書き続けていると、必ずと言っていいほど「負債」に直面しますよね。
「この古いライブラリの書き方を、全ファイルで新しいAPIに書き換えなきゃいけない……」「このメソッドの引数に、全箇所で `context` を追加しないといけない……」
そんな時、みなさんはどうしていますか？ まさか、VS Codeの文字列検索で頑張って置換して、あちこちでコンパイルエラーを吐かせて泣きそうになっていませんか？
実は、IntelliJ IDEAには「構造検索と置換（Structural Search and Replace: SSR）」という、魔法のような機能が備わっています。これは単なる文字列の検索ではありません。コードの文法構造（AST：抽象構文木）を理解して、意味論的にコードを検索・置換するツールです。
今日は、この「最強の武器」の使い方を、初心者のあなたにもわかるように伝授します。
—
1. なぜ「文字列置換」ではダメなのか？
私たちが普段書くコードは「文字列」ですが、コンピュータはそれを「木構造（AST）」として解釈しています。
例えば、`service.doSomething(a, b)` というコードを `service.execute(a, b, context)` に変えたいとします。これを正規表現でやろうとすると、改行やスペースの揺れ、引数の型の違いで必ず破綻します。
しかし、SSRなら「`$service$.doSomething($args$)` という構造を持つコードをすべて見つけ出し、`$service$.execute($args$, context)` に置き換えろ」という命令が書けるのです。これなら、どんなに複雑なコードでも一瞬で、しかも安全に変換できます。
—
2. 準備：構造検索の世界へ入る
まずはこの機能を開いてみましょう。
- メニュー: `Edit` -> `Find` -> `Replace Structurally…`
- ショートカット: `Ctrl+Shift+S` (Windows/Linux) / `Cmd+Shift+S` (Mac)
開くと、検索窓と置換窓、そして「テンプレート」という項目が見えるはずです。まずは何も考えず、一番シンプルな例から試してみましょう。
—
3. 実践：レガシーなログ出力を最新へ一括置換
例えば、プロジェクト全体に散らばっている古いログ出力 `System.out.println(“DEBUG: ” + val);` を、最新のロガー `log.debug(“DEBUG: {}”, val);` に置き換えるケースを考えてみましょう。
検索テンプレート（Search Template）
以下のテンプレートを入力してみてください。
// 検索する構造のパターン
// $obj$ はどんな変数でもマッチする「プレースホルダー」です
System.out.println(“DEBUG: ” + $val$);
置換テンプレート（Replace Template）
次に、置き換え後の形を指定します。
// 置換後の構造
// $val$ は検索時と同じ変数名を使うことで、中身がそのまま引き継がれます
log.debug(“DEBUG: {}”, $val$);
ここがすごい！
この状態で「Find」を押すと、IntelliJは単なる文字列としてではなく、「System.out.printlnというメソッド呼び出しの引数に、連結された文字列が入っているもの」を精緻に特定します。
「これ、もし引数が3つあったら？」
大丈夫です。テンプレート内の `$val$` をクリックし、右側の設定パネルで `Maximum count` を「Unlimited」に設定すれば、引数の数や種類がバラバラでも、自動的にASTを解析してマッチングしてくれます。
—
4. なぜこれが「最強の武器」なのか？
このツールを使いこなすと、開発の景色が変わります。
1. コンパイルエラーを未然に防ぐ: ASTベースで処理するため、コードが壊れるような中途半端な置換が発生しません。
2. 型を指定した検索: 例えば「特定のインターフェースを実装しているクラスのメソッドだけ」を検索対象にするといった、Javaの型情報を利用した絞り込みが可能です。
3. チームのコーディング規約を強制する: 「特定のライブラリの呼び出しは、必ずこのラッパーメソッド経由で行う」といったルールを、SSRで一括置換することで、チーム全体のコード品質を機械的に担保できます。
—
5. 初心者へのアドバイス：まずは「お試し」から
いきなり本番プロジェクトで置換するのは怖いですよね。その場合は、以下のステップで進めてください。
1. まずは「検索」だけ: 置換（Replace）ボタンは押さず、まずは「検索（Find）」だけで、期待する箇所が網羅できているか確認してください。
2. プレビューを確認: 検索結果には diff が表示されます。どのコードがどう変わるのか、IDEが事前に見せてくれるので安心です。
3. 履歴を活用: IntelliJは一度使ったテンプレートを記憶しています。よく使うパターンは「Save Template」しておけば、明日からあなたは「コードリファクタリングの達人」です。
—
最後に：ツールに支配されるな、ツールを支配せよ
レガシーコードは「悪」ではありません。かつて誰かが必死に書いた知恵の結晶です。それを破壊するのではなく、最新の技術スタックへ「進化」させることこそ、我々エンジニアの腕の見せ所です。
「手作業で直す」という苦行から卒業して、IntelliJ IDEAの脳（AST解析能力）をあなたの脳の一部として使ってみてください。毎日のコーディングが驚くほど速く、そして楽しくなるはずです。
もし使い方がわからないパターンがあれば、いつでも質問してくださいね。あなたのコードが、より美しくなることを応援しています！