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

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

CLion は、設定されたコードスタイル設定に従って [コードをフォーマット](reformat-and-rearrange-code.html)できます。 コマンドラインから指定したファイルにコードスタイルの書式を適用することもできます。

コマンドラインフォーマッターは、バックグラウンドで CLion のインスタンスを起動し、フォーマットを適用します。 すでに別の CLion のインスタンスが実行中の場合は機能しません。 この場合、実行中のインスタンスからコードスタイルのフォーマットを実行できます。 コマンドラインフォーマッタを使用して、多くのコントリビューターがいる大規模なコードベースの自動定期保守を行い、一貫したコーディングスタイルを確保します。

ファイルをフォーマットできるようにするには、CLion で対応するファイルタイプをサポートするプラグインをインストールして有効化してください（例えば、シェルスクリプトファイルをフォーマットする  Shell Script プラグイン）。

Windows:

CLion を実行するための実行可能ファイルは、 [インストールディレクトリ](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)の  `bin`  にあります。 この実行ファイルをコマンドラインランチャーとして使用するには、 [コマンドラインインターフェース](working-with-the-ide-features-from-command-line.html)の説明に従って、システム  `PATH`  に追加してください。

構文
: ```PLAINTEXT
: clion64.exe format [<options>] <path ...>
:
: ```

サンプル例
: デフォルトのコードスタイル設定を使用して、  `C:\Data\src`  ディレクトリから 2 つの特定のファイルをフォーマットします。
:
:
:
:
: ```SHELL
: clion64.exe format -allowDefaults C:\Data\src\hello.cpp C:\Data\src\world.cpp
:
: ```
:
:
:
: デフォルトのコードスタイル設定を使用して、すべてのサブディレクトリを含む  `C:\Data\src`  ディレクトリ内のすべてのファイルを再帰的にフォーマットします。
:
:
:
:
: ```SHELL
: clion64.exe format -allowDefaults -r C:\Data\src
:
: ```
:
:
:
: `C:\Data\settings.xml`  のコードスタイル設定を使用して、  `C:\Data\src`  ディレクトリ内のすべての  `.cpp`  および  `.h`  ファイルを非再帰的にフォーマットします。
:
:
:
:
: ```SHELL
: clion64.exe format -s C:\Data\settings.xml -m *.cpp,*.h C:\Data\src
:
: ```

macOS:

CLion にはコマンドラインコードフォーマッターを実行するためのスクリプトが含まれています。 デフォルトでは、アプリケーションパッケージ  `CLion.app/Contents/bin/format.sh`  にあります。

構文
: ```PLAINTEXT
:
: ./format.sh [<options>] <path ...>
:
: ```

サンプル例
: デフォルトのコードスタイル設定を使用して、  `~/Data/src`  ディレクトリから 2 つの特定のファイルをフォーマットします。
:
:
:
:
: ```SHELL
:
: ./format.sh -allowDefaults ~/Data/src/hello.html ~/Data/src/world.html
:
: ```
:
:
:
: デフォルトのコードスタイル設定を使用して、すべてのサブディレクトリを含む  `~/Data/src`  ディレクトリ内のすべてのファイルを再帰的にフォーマットします。
:
:
:
:
: ```SHELL
:
: ./format.sh -allowDefaults -r ~/Data/src
:
: ```
:
:
:
: `~/Data/settings.xml`  のコードスタイル設定を使用して、  `~/Data/src`  ディレクトリ内のすべての  `.cpp`  および  `.h`  ファイルを非再帰的にフォーマットします。
:
:
:
:
: ```SHELL
:
: format.sh -s ~/Data/settings.xml -m *.cpp,*.h ~/Data/src
:
: ```

Linux:

CLion を実行するためのスクリプトは、 [インストールディレクトリ](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)の  `bin`  にあります。 このスクリプトをコマンドラインランチャーとして使用するには、 [コマンドラインインターフェース](working-with-the-ide-features-from-command-line.html)の説明に従って、システムの  `PATH`  に追加してください。

構文
: ```PLAINTEXT
: clion.sh format [<options>] <path ...>
:
: ```

サンプル例
: デフォルトのコードスタイル設定を使用して、  `~/Data/src`  ディレクトリから 2 つの特定のファイルをフォーマットします。
:
:
:
:
: ```SHELL
: clion.sh format -allowDefaults ~/Data/src/hello.cpp ~/Data/src/world.cpp
:
: ```
:
:
:
: デフォルトのコードスタイル設定を使用して、すべてのサブディレクトリを含む  `~/Data/src`  ディレクトリ内のすべてのファイルを再帰的にフォーマットします。
:
:
:
:
: ```SHELL
: clion.sh format -allowDefaults -r ~/Data/src
:
: ```
:
:
:
: `~/Data/settings.xml`  のコードスタイル設定を使用して、  `~/Data/src`  ディレクトリ内のすべての  `.cpp`  および  `.h`  ファイルを非再帰的にフォーマットします。
:
:
:
:
: ```SHELL
: clion.sh format -s ~/Data/settings.xml -m *.cpp,*.h ~/Data/src
:
: ```

## オプション

|  オプション  |  説明  |
| --- | --- |
|   `-h`   |  ヘルプメッセージを表示して終了します。  |
|   `-m\|-mask`   |  処理するファイルを定義するファイルマスクのコンマ区切りリストを指定します。  `*`  （任意の文字列）および  `?`  （任意の 1 文字）ワイルドカードを使用できます。  |
|   `-r\|-R`   |  指定されたディレクトリを再帰的に処理します。  |
|   `-s\|-settings`   |     フォーマットに使用するコードスタイル設定ファイルを指定します。 これは次のいずれかです。        * エクスポートされたコードスタイル設定を含むファイル: エディター \| コードスタイル 設定ページ `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を開き、 ![The Show Scheme Actions button](https://resources.jetbrains.com/help/img/idea/2026.3/Project.xml` ファイル（CLion バージョン 2017.3 以降用）。      このオプションが指定されていない場合、ファイルはスキップされます。 親フォルダーの 1 つにプロジェクトがある場合、その設定は EditorConfig と同様に暗黙的に使用されます。     |
|   `-allowDefaults`   |  ファイルまたはファイルのグループに対してコードスタイルが定義されていない場合、つまり  `-s`  が設定されておらず、ファイルがどのプロジェクトにも属していない場合は、デフォルトのコードスタイル設定を使用します。 それ以外の場合、ファイルは無視されます。  |
|   `-charset`   |     エンコーディングを保持し、ソースファイルの読み取りと書き込みに文字セットを適用します（例:  `-charset ISO-8859-15`  ）。       このオプションは、コマンドラインフォーマッターがソースファイル内の特殊文字を正しく処理できない場合に便利です。     |
|   `-d\|-dry`   |  フォーマッタを検証モードで実行します。 フォーマッタはメモリ内で同じフォーマット操作を実行し、フォーマットされたファイルのいずれかが元のファイルと異なる場合、ゼロ以外のステータスで終了します。  |

