IntelliJの自動整形における差異とその対策

Last updated at 2025-07-06Posted at 2025-07-06

はじめに

現場で軽微なコード修正を行っただけなのに、GitHub Desktopを開くと大量の差分が発生して困った…という経験、ありませんか？
私自身、JUnitで .doReturn() のような「.から始まる表現」が保存時に自動整形される問題に直面しました。

Ctrl + Z で整形結果を戻しても…

Ctrl + S を押すと再び自動整形されてしまう。

今回は、そのような「望まない自動整形」を防ぐための設定項目と対策をまとめました。
※ 実際の現場での適用結果によっては、この記事も随時更新予定です。

たとえば、次のようにしたい場合です：

保存時（Ctrl + S）には整形させたくない

整形ショートカット（Ctrl + Alt + L）を使ったときだけ整形したい

コメントベースで整形のオン・オフを制御する
File → Settings → Editor → Code Style

Enable formatter markers in comments にチェックを入れる

その後、コード内に以下を記述：

// @formatter:off
.doReturn() // ← ここは整形されない
// @formatter:on

File → Settings → Tools → Actions on Save

以下のチェックを確認し、解消したいことに応じて外す：

✅ Reformat code（コードの再整形）

✅ Optimize imports（インポートの最適化）

✅ Rearrange code（コードの再編成）

必要に応じて「対象：変更された行のみ」を選択

File → Settings → Editor → General → Code Completion

「Insert selected suggestion by pressing enter」など、補完動作に連動する自動整形をオフにする設定を確認・調整

Settings → Editor → Code Style → Formatter

Do not format に *.java などの対象ファイルを設定
　※ 「Do not format に *.java を設定した場合、その .java ファイルには整形ショートカット（Ctrl + Alt + L）も効かなくなります」

Settings → Editor → General → Code Folding

「One-line methods」のチェックを外す
　→ 複数行メソッドが勝手に1行に変形されるのを防げます

File → Settings → Editor → General → Editor Tabs

「Hide tabs if there is no space」のチェックを外す
　→ タブが省略されず、常に表示されるようになります

もし以下のようなプラグインが導入されている場合：

Save Actions

Prettier（JavaScript/HTML/CSSなど）

この場合は別途そのプラグイン内の保存時トリガーを無効化する必要があります。

「うちの会社ではこうしてる」

「こんなトラブルがあった」
など、ぜひ気軽にコメントください！