CLion 2026.2 Help

代替フォーマッターとしての ClangFormat

ClangFormat(英語) は、チームメンバーと IDE 間で共通のコードスタイルを維持するのに役立つ一般的なコードフォーマットツールです。 それは .clang-format または _clang-format という名前の特別な YAML ファイルにフォーマット設定を保存するオプションを提供します。 CLion では、組み込みコードフォーマッタの代わりに ClangFormat を使用できます。

.clang 形式の設定ファイル

フォーマット規則を持つ .clang-format ファイルは、プロジェクトツリーに配置する必要があります。 それらはそれぞれ、同じレベルおよびサブディレクトリ内のコードファイルに適用されます。 1 つのプロジェクトに対して複数の .clang-format ファイルを用意することで、必要に応じて、コードフォルダーごとに異なるスタイルを使用できます。

ClangFormat には多くの スタイルオプションがあり(英語) 、組み合わせてチームに最適なルールのセットを作成できます。 また、C/C++ には、 LLVM(英語)Google(英語)WebKit(英語)Chromium(英語)Mozilla のいくつかの組み込みスタイルも用意されています。 これらの事前定義されたスタイルは、そのまま使用することも、カスタムのスタイル定義セットのベースラインとして使用することもできます。

たとえば、LLVM コードスタイルで .clang-format ファイルを生成するには、次のコマンドを実行します(ClangTools(英語) がすでに インストール(英語)されていることを確認してください)。

clang-format -style=llvm -dump-config > .clang-format

CLion の ClangFormat

CLion は自動的に ClangFormat を有効化し、プロジェクトルートに .clang-format ファイルがある場合に設定を適用します。 次のオプションのいずれかを使用して、 ClangFormat を有効 / 無効にすることもできます。

  • .h .c .cpp ファイルで、ステータスバーのコードフォーマットスイッチャーから ClangFormat を有効にする をクリックします。

    コードスタイルスイッチャーから ClangFormat を有効にする
  • あるいは、 設定 | エディター | コードスタイルClangFormat を有効にする チェックボックスを選択します。

    コードスタイル設定で ClangFormat を有効にするダイアログ

プロジェクトルートに .clang-format ファイルがない場合、CLion は現在の IDE コードスタイル設定に基づいてファイルを作成することを提案します。 拒否すると、ClangFormat はデフォルトの LLVM スタイルで有効になります。

現在のコードスタイルから .clang 形式を作成する

ClangFormat を有効にして新しいプロジェクトを作成すると、CLion は現在のコードスタイルに基づいて、そのプロジェクト用の .clang-format ファイルを自動的に生成します。

ClangFormat を有効にすると、次の場合に適切なフォーマットが適用されます。

  • エディターで入力する(これには、 Enter または バックスペース の後のインデント、自動補完、コード生成、リファクタリング、クイックフィックスが含まれます);

  • コード | コードの整形 Ctrl+Alt+L を呼び出す - このアクションでは、ファイル全体ではなく、選択したコードを再フォーマットすることもできます。

  • 変更をコミットし、 コードの整形コミットする前 アクションとして選択します:

    コミット前にコードを整形する

clang 形式のバイナリを変更する

  1. 設定 | エディター | コードスタイル | C++ に移動し、 一般 タブを開きます。

  2. Clang 形式 セクションで、 内蔵の clang フォーマットの代わりに外部の clang フォーマットを使用する を設定し、パスを指定します:

    カスタム clang 形式のバイナリの設定

ファイルの ClangFormat 設定を確認する

  • エディターでファイルを開き、ツールバースイッチャーから ... の ClangFormat オプションを表示する をクリックします。

    ファイルの ClangFormat 設定を表示する

    CLion は対応する .clang-format ファイルから取得した設定のリストを表示します。

    ClangFormat 設定ファイル

    このリストは現在読み取り専用です。 設定を編集するには、 .clang-format ファイルで設定を変更します。

.clang 形式のファイルを編集する

  1. エディターで目的のソースファイルを開き、ツールバースイッチャーから '.clang-format' を開きます ... をクリックします:

    clang 形式のファイルに切り替える
  2. .clang-format 構成の編集を支援するために、CLion は、 ClangFormat 専用に構築された JSON スキーマに対してファイルの内容を検証することにより、コーディング支援を提供します。 コーディング支援には次のものが含まれます。

    • オプションの説明がポップアップに表示され、オプションと値の補完が提供されます:

      code completion in clang-format config files
    • 許容値セットとの整合性についてオプション値を確認します:

      オプション値の検証
    • ドキュメントのポップアップ Ctrl+Q は、オプションの詳細を調べるのに役立ちます:

      clang 形式の設定ファイルのクイックドキュメント

フォーマッタ設定を .clang-format ファイルにエクスポートする

組み込みのコードフォーマッタの設定を保存または共有する必要がある場合は、 .clang-format ファイルにエクスポートできます。

  1. 設定 | エディター | コードスタイル | C/C++ に進みます。

  2. スキーム フィールドの横にある をクリックし、 エクスポート | .clang-format ファイル を選択します:

    フォーマッター設定を .clang-format にエクスポートする
  3. 開いたダイアログで、ファイル名と場所を指定します。 デフォルトでは、CLion は .clang-format と現在のプロジェクトルートを提案します。

2026 年 7 月 15 日