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

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

> **TL;DR**
> 設定 | エディター | コードスタイル | C/C++
>
>
>
> デフォルト: 無効
>
>
>
> バンドルされている  `.clang-format`  バージョン:  `設定 | エディター | コードスタイル | C/C++ | Clang-Format`  を参照

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

## .clang 形式の設定ファイル

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

ClangFormat   には多くの [スタイルオプションがあり(英語)](https://clang.llvm.org/docs/ClangFormatStyleOptions.html)、組み合わせてチームに最適なルールのセットを作成できます。 また、C/C++ には、 [LLVM(英語)](http://llvm.org/docs/CodingStandards.html)、 [Google(英語)](https://google.github.io/styleguide/cppguide.html)、 [WebKit(英語)](https://webkit.org/code-style-guidelines/)、 [Chromium(英語)](https://chromium.googlesource.com/chromium/src/+/master/styleguide/c++/c++.md)、 [Mozilla](https://developer.mozilla.org/en-US/docs/Mozilla/Developer_guide/Coding_Style) のいくつかの組み込みスタイルも用意されています。 これらの事前定義されたスタイルは、そのまま使用することも、カスタムのスタイル定義セットのベースラインとして使用することもできます。

たとえば、LLVM コードスタイルで  `.clang-format`  ファイルを生成するには、次のコマンドを実行します（ [ClangTools(英語)](https://clang.llvm.org/docs/ClangTools.html) がすでに [インストール(英語)](http://releases.llvm.org/download.html)されていることを確認してください）。

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

> **Tip:**
> 便利な対話型   .clang-format   ビルダー [clang 形式のコンフィギュレータ(英語)](https://clang-format-configurator.site)があります。

## CLion の ClangFormat

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

Procedure:

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

![コードスタイル設定で ClangFormat を有効にするダイアログ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangformat_engine.png)

* または、下の   Clang 形式   オプションを選択します。

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

![コードスタイルスイッチャーから ClangFormat を有効にする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangformat_switcherenable.png)

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

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

* コード | コードの整形 ( `Ctrl+Alt+L` (Windows), `⌘ ⌥ L` (macOS), `⌘ ⌥ L` (IntelliJ IDEA Classic (macOS)), `⌘ ⌥ L` (macOS System Shortcuts), `Ctrl+Alt+L` (XWin), `Ctrl+Alt+L` (GNOME), `Alt+Shift+L` (KDE), `Ctrl+Alt+L` (Emacs), `Ctrl+Alt+L` (Sublime Text), `⌘ ⌥ L` (Sublime Text (macOS)), `⌘ ⌥ L` (Xcode), `Ctrl+Alt+Enter` (Visual Studio), `⌘ ⌥ ⏎` (Visual Studio (macOS)), `Ctrl+Alt+L` (ReSharper), `⌘ ⌥ L` (ReSharper (macOS)), `Ctrl+;` (QtCreator), `⌘ ;` (QtCreator (macOS)), `Alt+Shift+F` (NetBeans), `Ctrl+Alt+L` (Eclipse), `⌘ ⇧ F` (Eclipse (macOS))) を呼び出します - このアクションでは、ファイル全体ではなく、選択したコードを整形することもできます。

* コードの整形 オプションを有効化した状態で変更をコミットします ( `Ctrl+O` (Windows), `⌃ O` (macOS), `⌃ O` (IntelliJ IDEA Classic (macOS)), `⌃ O` (macOS System Shortcuts), `Ctrl+O` (XWin), `Ctrl+O` (GNOME), `Ctrl+O` (KDE), `Ctrl+O` (Emacs), `Ctrl+O` (Sublime Text), `Ctrl+O` (Sublime Text (macOS)), `⌃ O` (Xcode), `Ctrl+O` (Visual Studio), `Ctrl+O` (Visual Studio (macOS)), `Ctrl+O` (ReSharper), `Ctrl+O` (ReSharper (macOS)), `Ctrl+O` (QtCreator), `Ctrl+O` (QtCreator (macOS)), `Ctrl+O` (NetBeans), `Ctrl+O` (Eclipse), `Ctrl+O` (Eclipse (macOS))): ![コミット前にコードの整形オプションを選択する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_commit_reformat.png)

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

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

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

![カスタム clang 形式のバイナリの設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangformat_custom.png)

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

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

![ファイルの ClangFormat 設定を表示する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangformat_viewsettings.png)

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

![ClangFormat 設定ファイル](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangformat_settingsfile.png)

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

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

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

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

![clang 形式のファイルに切り替える](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangformat_editconfig.png)

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](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangformat_completion.png)

* Checking the option values for consistency with the allowed value set: ![オプション値の検証](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangformat_optionvaluesmatch.png)

* [クイックドキュメントのポップアップ](viewing-inline-documentation.html) ( `Ctrl+Q` (Windows), `F1` (macOS), `⌃ J` (IntelliJ IDEA Classic (macOS)), `⌘ I` (macOS System Shortcuts), `Ctrl+Q` (XWin), `Ctrl+Q` (GNOME), `Ctrl+Q` (KDE), `Ctrl+Q` (Emacs), `Ctrl+Q` (Sublime Text), `Ctrl+Q` (Sublime Text (macOS)), `⌘ ⌃ ⇧ /` (Xcode), `Ctrl+K, I` (Visual Studio), `⌘ K, I` (Visual Studio (macOS)), `Ctrl+Q` (ReSharper), `⌃ Q` (ReSharper (macOS)), `Ctrl+Q` (QtCreator), `Ctrl+Q` (QtCreator (macOS)), `Ctrl+Q` (NetBeans), `Alt+Middle-Click` (Eclipse), `⌥ Middle-Click` (Eclipse (macOS))) は、オプションの詳細を調べるのに役立ちます: ![clang 形式の設定ファイルのクイックドキュメント](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangformat_quickdoc.png)

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

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

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

2. Click ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) next to the   スキーム   field and select   エクスポート | .clang-format ファイル  :

![フォーマッター設定を .clang-format にエクスポートする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_codestyles_export_to_clangformat.png)

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

