IntelliJ IDEA 2025.2 ヘルプ

コードの整形

IntelliJ IDEA を使用すると、現在のコードスタイルスキームまたは .editorconfig ファイルで指定した要件に従ってコードを再フォーマットできます。.editorconfig で定義されていないものがあれば、プロジェクト設定から取得されます。

コードの一部、ファイル全体、ファイルのグループ、ディレクトリ、モジュールを再フォーマットできます。また、コードの一部または一部のファイルを再フォーマットから除外することもできます。

コードフラグメントを再フォーマットする

  1. エディターで、再フォーマットしたいコードフラグメントを選択します。

    再フォーマットする前に、選択したコードに適用されているコードスタイル設定を確認できます。Alt+Enter を押してコードスタイルの設定を調整するをクリックします。

  2. メインメニューで、コード | コードの整形に移動するか、Ctrl+Alt+L を押します。

    または、表示されるツールバーで、 コードの整形をクリックします。

ファイルを再フォーマットする

  1. ファイルをエディターで開いて Ctrl+Alt+Shift+L を押すか、プロジェクトツールウィンドウでファイルを右クリックしてコードの整形を選択します。

  2. 開いたファイルの整形ダイアログで、必要に応じて、次の再フォーマットオプションを選択します。

    • インポートの最適化 : 未使用のインポートを削除する、足りないものを追加する、インポート文を整理するには、このオプションを選択します。

      詳しくは、インポートの最適化のセクションを参照してください。

    • エントリの再配置 : コードスタイル設定で指定された配置規則に基づいてコードを再配置する必要がある場合は、このオプションを選択します。

    • コードのクリーンアップ : コードクリーンアップインスペクションを実行するには、このオプションを選択します。

    • 改行を保持しない : コードスタイルの設定に従って改行を再フォーマットします。このオプションは、整形時の保持 | 改行設定を上書きします。

  3. 実行をクリックします。

    Reformat file dialog

    再フォーマット中にコードに加えられた正確な変更を確認するには、ローカル履歴機能を使用します。

モジュールまたはディレクトリを再フォーマットする

  1. プロジェクトツールウィンドウで、モジュールまたはディレクトリを右クリックしてコードの整形を選択するか、Ctrl+Alt+L を押します。

  2. 開いたダイアログで、再フォーマットオプションを指定します。

    また、スコープを指定したり、特定のファイルタイプに再フォーマットを絞り込んだりするなど、コードの再フォーマットにフィルターを適用することもできます。

    Module or directory reformat dialog

行のインデントを再フォーマットする

指定した設定に基づいて行のインデントを再フォーマットできます。

  1. エディター内で、必要なコードの一部を選択して Ctrl+Alt+I を押します。

  2. インデント設定を調整する必要がある場合は、設定ダイアログ (Ctrl+Alt+S) でエディター | コードスタイルに進みます。インデントを変更する言語を選択します。

  3. タブとインデントタブで、適切なインデントオプションを指定し、OK をクリックします。

保存時にコードを自動的に再フォーマットする

変更が保存されたときに、変更されたファイルのコードを自動的に再フォーマットするように IDE を構成できます。

  1. Ctrl+Alt+S を押して設定を開き、ツール | 保存時のアクションを選択します。

  2. コードの整形オプションを有効にします。

  3. さらに、IDE がコードを再フォーマットする方法を構成できます。

    • スコープの構成をクリックして、再フォーマットから除外するファイル名とディレクトリのパターンを指定します。

    • すべてのファイルタイプリストから、コードを再フォーマットするファイルのタイプを選択します。

    • プロジェクトがバージョン管理下にある場合は、ファイル全体または変更された行を選択します。

      変更された行を選択した場合、再フォーマットは、ローカルで変更されたが、リポジトリにまだチェックインされていないコード行にのみ適用されます。

コミット時にコードを再フォーマットする

プロジェクトがバージョン管理されている場合は、リポジトリに変更をコミットするときに、コードを自動的に再フォーマットできます。この場合、追加または変更されたコードのみが再フォーマットされます。

  1. Alt+0 を押してコミットツールウィンドウを開き、コミットオプションを表示 the Settings button をクリックします。

  2. コミットチェックメニューで、コードの整形オプションを有効にします。

オプションを有効にすると、コミットするたびに追加または変更されたコードが再フォーマットされます。

Reformatting code on commit

コマンドラインからコードを再フォーマットする

IntelliJ IDEA は、コマンドラインから指定されたファイルにコードスタイルのフォーマットを適用できます。

  1. お使いの OS 用のコマンドラインランチャーがあることを確認してください。

  2. format コマンドを実行します。

コマンドラインからファイルをフォーマットする詳細を参照してください。

再フォーマットからファイルを除外する

ファイルとディレクトリのグループを、再フォーマット、コード配置、およびインポートの最適化から除外できます。

  1. 設定ダイアログ(Ctrl+Alt+S)で、エディター | コードスタイルに移動します。

  2. フォーマッタータブに切り替え、フォーマットしないフィールドに、グロブパターン(英語)を使用して除外するファイルとディレクトリを入力します。

    セミコロン ; で区切られた複数のグロブパターンを指定できます。the Expand icon をクリックすると、フィールドが展開され、各パターンが別々の行に表示されます。

  3. 変更を適用し、ダイアログを閉じます。

    Specifying a glob pattern for excluding files from reformatting

エディターでのコードフラグメントの再フォーマットからの除外

  1. 設定ダイアログ(Ctrl+Alt+S)で、エディター | コードスタイルに移動します。

  2. フォーマッタータブに切り替えて、コードコメント内のマーカーでフォーマッターのオン / オフを切り替えるオプションを有効にします。

  3. エディターで、除外する領域の先頭に、行コメント Ctrl+/ を作成し、@formatter:off と入力します。領域の最後に、別の行コメントを作成し、@formatter :on と入力します。

    マーカー間のコードは再フォーマットされません。

    Formatting markers

フォーマットマーカーの使用例

既存のフォーマットを保持

コードを再フォーマットするときに無視されるフォーマット規則を選択できます。例: 単純なメソッドや関数を 1 行に収めるように IDE を調整することができますが、通常はコードの再フォーマット後に複数行に展開されます。

  1. メインメニューで設定 | エディター | コードスタイルに移動し、プログラミング言語を選択して、折り返しと波括弧タブを開きます。

  2. 整形時の保持セクションで、無視したいフォーマット規則を選択し、適用するものを選択解除します。

  3. コードを再フォーマットする (Ctrl+Alt+L).

IntelliJ IDEA は現在のスタイル設定に従ってあなたのコードを再フォーマットし、選択したルールのための既存のフォーマットを維持します。

フォーマッタ設定

設定にアクセスするには、設定ダイアログ (Ctrl+Alt+S) でエディター | コードスタイルに移動し、フォーマッタータブに切り替えます。

項目

説明

フォーマットしない

フォーマットしないフィールドで、再フォーマットコード配置インポート最適化から除外するファイルとディレクトリの名前を含む glob パターン(英語)を指定します (例: *.{html,htm})。

セミコロン ; で区切って複数のグロブパターンを指定できます。

再フォーマットを完全に無効にするには、アスタリスク * ワイルドカードを使用します。

コードコメント内のマーカーでフォーマッターのオン / オフを切り替える

  • このオプションを有効にすると、フォーマットマーカーのある行コメント間のコードのフラグメントは、これらのマーカーに従って再フォーマットされます。オンマーカーのあるコードフラグメントは再フォーマットされ、オフマーカーのあるコードフラグメントは、コードを再フォーマットした後もそのまま残ります。フォーマットマーカーの使用例を参照してください。

    このチェックボックスを選択すると、以下のフィールドが使用可能になり、フォーマットマーカーとして扱う文字列を指定できます。

  • このオプションを無効にすると、フォーマットマーカーは無視され、マーカー付きの行コメント間のコードが再フォーマットされます。

オフ:

このフィールドには、再フォーマットから除外したいコードフラグメントの始まりを示す文字文字列を指定してください。@ シンボルを前置にして文字文字列を入力するか、事前定義値 @formatter:off のままにしてください。

オン:

このフィールドには、再フォーマットから除外したいコードフラグメントの終わりを示す文字文字列を指定してください。@ シンボルを前置にして文字文字列を入力するか、事前定義値 @formatter:on のままにしてください。

フォーマッターマーカーで正規表現を使用可能にする

フォーマットマーカーを明示的に指定する代わりに正規表現を使用するには、このチェックボックスをオンにします。IntelliJ IDEA は、正確な文字列の代わりに指定された正規表現を使用して、フォーマッタのオン / オフマーカーを照合します。

例: 正規表現を使用すると、フォーマッターを有効または無効にするためのいくつかのマーカーを使用できます。その場合、次の正規表現を使用できます: @formatter:(off|disable|no) および @formatter:(on|enable|yes)

デモについては、フォーマットマーカーの使用例を参照してください。

Example of using different formatter markers
2025 年 9 月 30 日

関連ページ:

コードスタイルスキーム

IDE には、プロジェクトスキームとデフォルトスキームの 2 つの定義済みスキームが付属しています。プロジェクトスキームでは、構成する設定は現在のプロジェクトにのみ適用されます。これらの設定は、.idea の codeStyles フォルダーに保存され、VCS を介してプロジェクトと共有されます。プロジェクトのコードスタイル設定を変更すると、IDE によってフォルダーが作成されます。デフォルトスキーム(IDE レベルのスキーム)では、構成する設定は、デフォルトコードスタイルスキームが選択されている既存...

EditorConfig

IntelliJ IDEA を使用すると、EditorConfig をサポートする個々のファイルセットのすべてのコードスタイル設定を管理できます。必要なのは定義したいコードスタイルのファイルを含むルートディレクトリに .editorconfig ファイルを置くことです。プロジェクトに複数のコードスタイルがある場合(たとえば、テスト用や本番コード用)、プロジェクトの対応するフォルダーに複数の .editorconfig ファイルを含めることができます。これにより、同時に複数のコードスタイル標準に従うことがで...

ソースコードの作成と編集

コードを使用する場合、IntelliJ IDEA は作業にストレスがないことを保証します。追加、選択、コピー、移動、編集、折りたたみ、出現箇所の検索、コードの保存に役立つさまざまなショートカットと機能を提供します。エディター内のナビゲーションについては、エディターの基本を参照してください。文字の入れ替えエディターで、交換する文字にキャレットを配置します。に移動します。このアクションのデフォルトのショートカットはありません。カスタムショートカットを割り当てることができます。フローティングツールバー...

自動インポート

まだインポートしていないクラス、静的メソッド、静的フィールドを使用している場合、IDE は不足しているインポート文を追加するよう促すツールヒントを表示します。これにより、手動で追加する必要がなくなります。提案を受け入れるには、を押してください。インポート可能なソースが複数ある場合、を押すと候補のリストが開きます。インポートツールチップの背景色を変更するには、を押してに移動します。インポートステートメントを自動的に追加する:選択肢がない場合は、インポート文を自動的に追加するように IDE

コードの再配置

配置ルールの構成:設定ダイアログのコードスタイルページで設定された配置規則に従って、コードを再配置できます。ルールのグループ(エイリアス)を作成し、一致するルールを作成するときに参照することもできます。グループ化ルールを構成するグループ化ルールを使用すると、関連するクラスメソッドをまとめることができます。を押して設定を開き、エディター | コードスタイル | Java を選択します。配置タブで、グループ化ルール領域のグループ化オプションを選択します。依存メソッドをまとめるオプションの場合、深さ優...

ローカル履歴

ローカル履歴は、バージョン管理とは関係なく、プロジェクトに加えられたすべての変更を常に追跡できます。コミット間で行われた違いのみを追跡するバージョン管理システムとは異なり、ローカル履歴にはさらに多くの機能があります。コードの編集、テストの実行、アプリケーションのデプロイなどを行うと、プロジェクトの状態が自動的に記録され、IDE と外部の両方から行われたすべての意味のある変更のリビジョンが維持されます。ローカル履歴を使用すると、個人のバージョン管理システムとして機能し、プロジェクトでバージョン管理...