# パフォーマンス調整のヒント

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

この記事では、大規模プロジェクトで作業する際の CLion パフォーマンスを向上させるためのテクニックの概要を説明します。

## メモリヒープを増やす

Procedure: メモリインジケーターを有効にする

ステータスバーの右下隅にある 2 つのインジケーター（一般的なメモリインジケーターと [Clangd](#check-clangd) のメモリ使用状況インジケーター）を監視することで、パフォーマンスの低下がヒープメモリの不足によるものかどうかを確認できます。

1. `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `⌘ ⇧ A` (Xcode), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+Shift+A` (ReSharper), `⌘ ⇧ A` (ReSharper (macOS)), `Ctrl+Shift+A` (QtCreator), `⌘ ⇧ A` (QtCreator (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS)) を押して   アクションの検索   ダイアログを開きます。

2. memory と入力し始めてから、2 つのオプション   Clangd のメモリ使用量を表示する   と   メモリインジケーターを表示する   を有効化します：

![「なんでも実行」でメモリインジケーターを検索する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_runanything_memoryindicators.png)

3. CLion はインジケーターをステータスバーに追加します：

![Clangd メモリインジケーター](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangd_memoryindicator_newui.png)

![メモリインジケータ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_memoryindicator_newui.png)

> **Tip:**
> どちらのインジケーターもステータスバーのコンテキストメニューからオン / オフを切り替えることができます。

Procedure: メモリ設定の変更でヒープを増やすダイアログ

1. メインメニューから  `ヘルプ | メモリ設定を変更`  を選択します。

2. 開いたダイアログで、   最大ヒープサイズ   フィールドにより高いメモリヒープ値を設定します。

3. 保存して再起動   をクリックします。

Procedure: Toolbox からメモリヒープを増やす

Toolbox   アプリからヒープサイズを変更することもできます。

1. Toolbox で、CLion バージョンを選択し、右側のねじナットボタンをクリックします。

2. 開いたメニューから   設定  を選択します：

![JetBrains Toolbox における CLion の設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolbox_settings.png)

3. 構成   セクションに移動し、   最大ヒープサイズ   フィールドに新しい値を設定します：

![CLion ヒープサイズを JetBrains Toolbox から変更](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolbox_heapsize.png)

4. CLion を再起動してください。

Procedure: -Xmx を調整する

メモリヒープを増やすには、JVM の最大ヒープサイズを設定する  `-Xmx`  オプションを変更します。

1. メインメニューで  `ヘルプ | カスタム VM オプションの編集`  へ移動します。 このアクションにより、IDE 構成ディレクトリに  `.vmoptions`  ファイルのコピーが作成され、エディターで開きます。

2. `-Xmx`  値を更新します。 例:  `-Xmx4096m`  を使用して、デフォルトの 2 GB ではなく 4 GB のメモリを割り当てます。

3. 変更を適用するには、CLion を再起動します。

空きヒープメモリの量が最大ヒープサイズの 5% を下回ると、警告が表示されます。  `-Xmx`  値を調整するには、警告ボックスで「   構成   」をクリックしてください。

![メモリ不足の警告](https://resources.jetbrains.com/help/img/idea/2026.3/cl_lowmemory_warning_newui.png)

Procedure: Clangd に割り当てられているメモリの量を変更する

1. `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `⌘ ⇧ A` (Xcode), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+Shift+A` (ReSharper), `⌘ ⇧ A` (ReSharper (macOS)), `Ctrl+Shift+A` (QtCreator), `⌘ ⇧ A` (QtCreator (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS)) を押して   アクションの検索   ダイアログを開きます。

2. Registry を検索します：

![検索アクションでのレジストリの検索](https://resources.jetbrains.com/help/img/idea/2026.3/cl_findaction_registry_newui.png)

3. Registry   ダイアログで、  clion.clangd.max.memory  と入力し始めます。

4. 希望する値を設定し、ダイアログを閉じます。

![Clangd メモリレジストリキー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_clangd_registry_maxmemory.png)

## コード分析をスピードアップ

オンザフライコード解析は、CLion で最もパフォーマンスを消費するプロセスの一つです。 軽くするためにできることは次のとおりです。

Procedure: ファイルの分析を調整する

オンザフライコード解析は、CLion で最もパフォーマンスを消費するプロセスの一つです。 この処理を軽量化するために、現在開いているファイルのハイライトレベルを「なし」、「構文」、「すべての問題」のいずれかに設定できます。

* エディターの右上隅にあるインスペクションウィジェットを使用します。

![インスペクションウィジェット](https://resources.jetbrains.com/help/img/idea/2026.3/cl_inspection_widget.png)

Procedure: 省電力モードを有効にする

次のいずれかのオプションを使用して、省電力モードまたはバッテリー効率モードを有効にできます。

* 個々のチェックやファイルを一つずつ無効にする代わりに、   省電力モード   をお試しください。 このモードでは、IDE 全体でインスペクションやその他のリソースを大量に消費するプロセスがすべて無効になります。

省電力モード   を有効にするには、  `ファイル | 省電力モード`  に進みます。

![省電力モードが有効化されました](https://resources.jetbrains.com/help/img/idea/2026.3/ri_power_save_mode_on.png)

* [ステータスバー](guided-tour-around-the-user-interface.html#status-bar)を右クリックし、「   省電力モード   」を選択します。 ステータスバーに「 ![Power Save Mode icon](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.inspections.inspectionsPowerSaveMode.png)   省電力モード   」アイコンが表示されます。

Procedure: Clangd ベースのエンジンを確認する

* CLion には、デフォルトで有効化されている補完的な [Clangd ベースの言語エンジン](settings-languages-cpp-clangd.html)が組み込まれています。 現在、エラー / 警告のアノテーション、特定のナビゲーションタスク、 [ClangFormat](clangformat-as-alternative-formatter.html) を使用したコードのフォーマット、クイックフィックスによるコードのハイライトで機能します。

ほとんどの場合、Clangd ベースのエンジンは、組み込みのエンジンよりも高速に動作します（場合によっては、より正確な結果が得られます）。 ただし、  すべての操作に使用されるわけではありません 。 例: Clangd はクイックフィックスの場所を提供しますが、修正自体は CLion 自体のエンジンによって実行されます。 または、   使用箇所の検索   は Clangd を使用して、エディターで現在開いているファイルを検索し、CLion 独自のエンジンを使用して他のすべての使用箇所を検索します。

パフォーマンスの問題を調査するときは、Clangd エンジンの仕様を考慮することをお勧めします。  `設定 | 言語 & フレームワーク | C/C++ | Clangd`  を使用して、エンジン設定を実験し、特定のタスクのパフォーマンスに影響するかどうかを確認します。

## プロジェクト分析を高速化

Procedure: ディレクトリとファイルの種類を除外する

* デフォルトでは、CLion は [CMakeLists.txt](cmake-profile.html) にリストされているすべてのディレクトリ (  `sources`  および  `include_directories`  パスを含む) にインデックスを付けて、適切なコード解決を保証します。

プロジェクトには、バイナリやログ、ビルド成果物など CLion のコードインサイトに影響しないフォルダーが含まれている場合があります。 このようなフォルダーは、そのサイズや場所によってリソース消費が激しくなることがあります。 このような場合は、フォルダーを手動で除外することをお勧めします。プロジェクトツリーでディレクトリを右クリックし、  `ディレクトリをマーク | 除外` を選択します。

![ディレクトリを除外としてマークする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_markdir_excluded.png)

ファイルが除外されると、そのシンボルは CLion で利用できなくなります。 除外されたファイルに対しては、コード補完、自動インポート（除外されたディレクトリが  `CMakeLists.txt`  内の  `include_directories`  によって参照されている場合を除く）、コード生成、ファイル内検索（開いているファイルを除く）、ナビゲーション、リファクタリングなどの機能が無効になります。

> **Tip:**
> リモート開発モードで作業している場合、除外されたディレクトリはリモートマシンと同期されません。 [ローカルソースを使用したリモート: 除外対象パス](remote-projects-support.html#excluded-paths)を参照してください。

* ログや生成されたデータなどのファイルをファイルの種類別に除外することもできます。

1.   `設定｜エディター｜ファイルタイプ`  に移動し、   無視するファイルとフォルダー   タブに切り替えます。

2.  無視されるファイルタイプのリストに新しい拡張機能 ( ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)) を追加します：

![無視されるファイルの種類](https://resources.jetbrains.com/help/img/idea/2026.3/cl_ignore_files.png)

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

> **Tip:**
> 標準 IDE インデックスからディレクトリを削除せずに、テストインデックスからディレクトリを除外することもできます。 [テストのインデックス作成を高速化する](exclude-test-directories-from-indexing.html)を参照してください。

### より小さな CMake サブプロジェクトを操作する

解析されるファイルのスコープは、ロードされた CMake スクリプトによって決まります。 プロジェクトが複数のサブディレクトリに分割され、それぞれに自己完結型  `CMakeLists.txt`  が含まれている場合は、より小さいサブプロジェクトを個別に読み込むことができます (そのためには、sub-CMakeLists.txt で   CMake プロジェクトを読み込む   を実行します)。

![CMake サブプロジェクトをロードする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_loadcmake_subproject.png)

大規模なプロジェクトの一部のみを探索する必要がある場合の別の方法として、 [compilation database](compilation-database.html) を作成し、目的の部分に絞り込み、その後 CLion でプロジェクトとして開きます。

### _CLION_IDE__ マクロを使用して、重い解析を排除する

複雑なプリプロセッサーマクロの解析中に IDE のフリーズが発生する場合があります。 このような問題のある定義をコードから削除するには、  `__CLION_IDE__`  （または  `__JETBRAINS_IDE__`  ）マクロを使用してダミーの定義に置き換えます。

![CLion IDE マクロ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_idemacro.png)

このマクロは解析のみに影響し、コードをビルドまたは実行するときは未定義です。

## 不要なプラグインを無効にする

IDE のパフォーマンスを向上させるには、不要な [プラグイン](managing-plugins.html) を無効化してみてください。 後でいつでも再びオンにすることができます。

例えば、特定の [テストフレームワーク](unit-testing-tutorial.html) を使用している場合は、CLion でサポートされている他のテストフレームワーク向けプラグインを無効化することを検討してください。

Procedure:

1. `設定 | プラグイン`  に進みます。

2. 不要なプラグインを無効化する:

![不要なプラグインを無効にする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_disable_unreq_plugins.png)

![設定ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) のメニューから、手動でインストールしたすべてのプラグイン（バンドルされていないプラグイン）を一度に無効にすることもできます。

![ダウンロードしたプラグインをすべて無効にする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_plugins_disable_downloaded_newui.png)

## パフォーマンスの問題を報告する

IDE がフリーズしたり、CPU やメモリの使用率が高かったりして、上記のヒントを試しても改善しない場合は、IDE ログ、スレッドダンプ、パフォーマンススナップショットをご提供ください。 これらの情報の収集と送信方法の詳細については、 [こちらの手順](https://intellij-support.jetbrains.com/hc/en-us/articles/207241235-Reporting-performance-problems)を参照してください。

