llms.txt: machine-readable documentation index. Markdown version of this page is also available.

CLion 2026.3 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

次のいずれかのオプションを使用して、 ClangFormat を有効化または無効化できます:

  • .clang-format ファイルのフォーマットオプションを組み込みの CLion フォーマッターで使用するには、 設定 | エディター | コードスタイル | C/C++ | 一般 | C/C++ フォーマットエンジン に移動し、 %instance% フォーマッター を選択して、 .clang 形式のファイルからコードスタイルを読み取る チェックボックスを有効化します。

    コードスタイル設定で ClangFormat を有効にするダイアログ
  • または、下の Clang 形式 オプションを選択します。

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

    コードスタイルスイッチャーから ClangFormat を有効にする

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

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

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

  • コードの整形 オプションを有効化した状態で変更をコミットします (Ctrl+O):

    コミット前にコードの整形オプションを選択する

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

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

  2. In the Clang 形式 section, set the バンドル版の代わりに外部 clang-format を使用する and provide the path:

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

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

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

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

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

    ClangFormat 設定ファイル

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

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

.clang-format ファイルを保存すると、CLion は変更を自動的に適用します。

  1. Open the desired source file in the editor and click '.clang-format' を開きます ... from the toolbar switcher:

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

    • Completion for options and values, with option descriptions shown in the popup:

      code completion in clang-format config files
    • Checking the option values for consistency with the allowed value set:

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

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

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

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

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

  2. Click next to the スキーム field and select エクスポート | .clang-format ファイル:

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

2026 年 11 月 6 日