【Eclipse】ファイル保存時にCheckstyleを自動実行する方法

Posted at 2026-01-07

はじめに

Javaの開発において、コードスタイルの統一は非常に重要です。チーム開発ではもちろん、個人開発でも一貫したコーディングスタイルを保つことで、可読性の高いコードを維持できます。

今回は、EclipseでCheckstyleを導入し、ファイル保存時に自動でコードチェックを実行する方法をご紹介します。

まずはEclipseにCheckstyleプラグインをインストールしましょう。

💡 Tips: すでにインストール済みの場合は、この手順はスキップしてください。

プラグインをインストールしただけでは、まだCheckstyleは動作しません。
プロジェクトごとに有効化する必要があります。

[プロジェクト右クリック]
    └── Properties
          └── Checkstyle
                └── ✅ Checkstyle active for this project

デフォルトでは以下の設定が用意されています：

Configuration名	説明
Sun Checks	Sun Microsystems（現Oracle）のコーディング規約
Google Checks	Googleのコーディング規約

チーム独自のルールを使いたい場合は、カスタム設定ファイル（checkstyle.xml）を読み込むこともできます。

ここが最も重要なポイントです！

Checkstyleはビルド時に実行されるため、自動ビルドが有効になっていないと、ファイル保存時にチェックが走りません。

Project
  └── ✅ Build Automatically  ← これにチェック！

⚠️ 注意: この設定がオフになっていると、ファイルを保存してもCheckstyleが実行されません。

上記の設定を行っても動作しない場合は、Buildersの設定を確認しましょう。

Builders
  └── ✅ Checkstyle Builder  ← 有効になっているか確認
  └── ✅ Java Builder

設定が完了したら、実際に動作確認してみましょう。

// 例：スペースの問題があるコード
public class Sample{  // ← {の前にスペースがない
    public void test(){
        int x=1;  // ← =の前後にスペースがない
    }
}

この設定により、ファイルを保存するたびに自動でコードスタイルがチェックされ、違反があれば即座に警告が表示されるようになります。

コードレビューの負担軽減や、品質の高いコードを維持するために、ぜひCheckstyleを活用してみてください！

最後まで読んでいただきありがとうございました！
この記事が参考になりましたら、ぜひ「いいね」をお願いします 👍