# デバッガーオプション

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

> **Note:**
> CLion 2026.2 以降、デバッガーの選択と設定は [デバッグプロファイル](debug-profiles.html)を使用し、メインツールバーから切り替えます。 ツールチェーン設定の   デバッガー​  フィールドは非推奨となりました。

CLion allows you to debug C and C++ executables using the following debuggers:

* macOS および Linux 上の [LLDB(英語)](https://lldb.llvm.org)。

* Windows では [GDB(英語)](https://www.gnu.org/software/gdb)、Linux。

* Windows 上の MSVC ツールチェーン用の [LLDB ベースのデバッガー](quick-tutorial-on-configuring-clion-on-windows.html#msvc-debugger)。

* すべてのプラットフォーム上のカスタム GDB。

* macOS および Linux 上のカスタム LLDB (WSL、Docker、リモートホストツールチェーンではまだ動作しません)。

* すべてのプラットフォームで [デバッグアダプタープロトコル (DAP)](dap-support.html) をサポートするデバッガー。

バンドルされているデバッガーの現在のバージョンは次のとおりです。

|  バンドルされたデバッガー  |  バージョン  |  サポートされるプラットフォーム  |
| --- | --- | --- |
|  LLDB  |  21.1.7  |  macOS, Linux  |
|  GDB  |  17.1  |  Windows、Linux  |
|  MSVC ツールチェーン用の LLDB  |  9.0.0*  |  Windows  |

> **Note:**
> MSVC ツールチェーンで LLDB v9.0.0 を使用する理由 。 これは、PDB ファイルを処理する際のパフォーマンスと精度が大幅に改善され、Natvis フレームワークのサポートも含まれている、大幅に変更された LLDB のフォークです。 これらの変更は、MSVC ツールチェーンで効果的にデバッグするために不可欠です。 そのため、現在 MSVC ツールチェーンで別の LLDB バージョンを使用することはできず、更新するプランもありません。

Procedure: デバッガー間の切り替え

1. メインツールバーのデバッグプロファイルスイッチャーからデバッグプロファイルを選択します。 スイッチャーでは現在のプロファイルが   デバッグ｜<profile>  として表示されます。

![メインツールバーのデバッグプロファイルスイッチャー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_profiles_switcher.png)

2. プロファイルを追加または編集するには、  `設定 | ビルド、実行、デプロイ | デバッガー | デバッグプロファイル` に移動します。 詳細については、 [デバッグプロファイル](debug-profiles.html)を参照してください。

## デバッガーのデータビュー

`設定 | ビルド、実行、デプロイ | デバッガー | データビュー | C/C++`  ダイアログでは、C/C++ データ表現をカスタマイズできます。

![C/C++ デバッガーデータビューの設定](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debugger_dataviews_cpp.png)

ここでは、標準ライブラリ型のレンダリング、モジュール名、関数パラメーター型と関数テンプレート引数、その他のオプションを制御できます。 または、 [デバッグツールウィンドウ](debug-tool-window.html)、フレームビュー、変数ビューでコンテキストメニューを使用します。

![変数はコンテキストオプションを表示する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debugtw_variables_contextoptions.png)

### STL コンテナーのレンダリング

GNU ライブラリレンダラを有効にする   チェックボックスを設定すると、  gcc  コンパイラーの使用時に GDB による STL コンテナーのレンダリングに影響します。  clang  を GDB と組み合わせて使用する場合、このオプションは  `libstdc++`  に対してのみ機能します (詳細については、 [次の章](#gdb-config)を参照してください)。

現在、このオプションは LLDB には適用されません。 LLDB（バージョン 9.0 以降）が以下の   LLDB STL フォーマッタ   で  `libc++`  および  `libstdcxx`  を処理する方法を確認してください。

#### LLDB STL フォーマッタ

以下のリストは、LLDB バージョン 9.0 で正確です。

macOS:

|  タイプ  |  libcxx  |  libstdc++  |
| --- | --- | --- |
|  string  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  array  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  ベクター  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  デック  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  リスト  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  フォワードリスト  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  設定​タイトル​  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  map  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  マルチセット  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  マルチマップ  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  unordered_set  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  unordered_map  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  unordered_multiset  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  unordered_multimap  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  スタック  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  キュー  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  priority_queue  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |

Ubuntu:

|  タイプ  |  libcxx  |  libstdc++  |
| --- | --- | --- |
|  string  |   `-fstandalone-debug`  でコンパイルした場合は ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  array  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  ベクター  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  デック  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  リスト  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  フォワードリスト  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  設定​タイトル​  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  map  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  マルチセット  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  マルチマップ  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  unordered_set  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  unordered_map  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  unordered_multiset  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  unordered_multimap  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![minus_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/minus_retina.png)  |
|  スタック  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  キュー  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |
|  priority_queue  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |  ![check_retina.png](https://resources.jetbrains.com/help/img/idea/2026.3/check_retina.png)  |

#### macOS 上の GDB の STL レンダラー

デバッグバックエンドとしての   GDB   と   Clang   （   CMake   のデフォルトコンパイラー）の組み合わせは、macOS で STL コンテナーのコンテンツを表示する際の制限を意味します。 回避策として、次の手順を試してください。

Procedure:

1. `libc++`  の代わりに  `libstdc++`  ライブラリを使用してください。 To include  `libstdc++`  in your project, add the following command in [CMakeLists.txt](cmakelists-txt-file.html):

```CMAKE
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -stdlib=libstdc++")

```

または、  `設定 | ビルド、実行、デプロイ | CMake`  に移動し、   CMake のオプション   フィールドでライブラリを指定します。

```
-DCMAKE_CXX_FLAGS="-stdlib=libstdc++"

```

> **Note:**
> libstdc ++  は、  GCC 4.2.1  のレベルで C++ のサポートを提供します。 詳細については、 [http://libcxx.llvm.org/](http://libcxx.llvm.org/) を参照してください。

2. dwarf3  デバッグ情報形式を使用することもお勧めします。 このために、次のコマンドを  `CMakeLists.txt`  に追加します。

```CMAKE
set(CMAKE_CXX_FLAGS_DEBUG "${CMAKE_CXX_FLAGS_DEBUG} -gdwarf-3")
set(CMAKE_C_FLAGS_DEBUG "${CMAKE_C_FLAGS_DEBUG} -gdwarf-3")

```

## カスタム .gdbinit/ .lldbinit ファイル

プロジェクトでデバッグ用にさらに多くの構成オプションが必要な場合は、カスタム初期化ファイル（GDB の場合は [.gdbinit(英語)](https://sourceware.org/gdb/current/onlinedocs/gdb.html/Initialization-Files.html)、LLDB の場合は [.lldbinit(英語)](https://lldb.llvm.org/man/lldb.html#configuration-files)）を作成し、プロジェクトルートに配置できます。 このファイルは、他のプロジェクトファイルと一緒に [VCS](version-control-integration.html) を介して共有できます。

> **Tip:**
> Note that  `.gdbinit`  /  `.lldbinit`  files are not tied to the IDE and work similarly when used outside CLion.

通常、GDB/LLDB は、起動時に特定の順序で複数の初期化ファイルをロードします。 最初に、デバッガーはユーザーのホームディレクトリで初期化ファイルを探し、次に現在の作業ディレクトリ（プロジェクトルート）でファイルを探します。

デフォルトでは、セキュリティ上の理由から、プロジェクト固有の init ファイルからのコマンドは実行されません。 これを可能にするには、以下に説明するように、ホームディレクトリの init ファイルを変更します。

Procedure: プロジェクト固有の .gdbinit/ .lldbinit の読み取りを有効にする

GDB:

`~/.gdbinit`  ファイルに権限を設定します。

GDB 11.1 以降では、代わりに  `$HOME/.config/gdb/gdbinit`  または  `$HOME/Library/Preferences/gdb/gdbinit`  を使用できます。

[WSL](how-to-use-wsl-development-environment-in-product.html) を使用する場合は、WSL のホームディレクトリ  `/home/[user]/.gdbinit`  にある  `.gdbinit`  ファイルを編集します。

* すべてのプロジェクト ```CONSOLE set auto-load local-gdbinit on add-auto-load-safe-path / ``` > **Note:** > これにより、デバッガーはすべてのプロジェクトでプロジェクト固有の初期化ファイルを読み取れるようになり、コマンドライン GDB を使用して、現在の作業ディレクトリから `.gdbinit` を読み取れるようになります。 信頼できないコマンドが実行される可能性があるため注意してください。

* 特定のプロジェクト用 ```CONSOLE set auto-load local-gdbinit on add-auto-load-safe-path [full path to the project root]/.gdbinit ```

LLDB:

ホーム  `~/.lldbinit`  ファイルに権限を設定します。

```CONSOLE
settings set target.load-cwd-lldbinit true
```

> **Note:**
> これにより、デバッガーはすべてのプロジェクトでプロジェクト固有の初期化ファイルを読み取れるようになり、コマンドライン LLDB を使用して、現在の作業ディレクトリから  `.lldbinit`  を読み取れるようになります。 信頼できないコマンドが実行される可能性があるため注意してください。

## GDB タイムアウト値の調整

CLion レジストリで対応するプロパティを設定することにより、GDB タイムアウト値を制御できます。

Procedure:

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)) を押すか、メインメニューから  `ヘルプ | アクションの検索`  を選択します。 開いたポップアップで、  `Registry`  の入力を開始し、対応する項目を選択して `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) を押します。

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

2. 開いたダイアログで、   cidr.debugger.timeout   と入力し始めます。 ハイライトされた文字列の   値   フィールドをクリックし、タイムアウト値をミリ秒単位で入力します。

![GDB タイムアウトのレジストリキー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_registryDebuggerTimeout.png)

## Windows 上での外部 GDB コンソールの設定

8.0 より前のバージョンの GDB を使用する Windows では、アプリケーションの入出力に別のコンソールが使用されます。 新しい GDB バージョンの場合、出力はデフォルトで CLion コンソールにリダイレクトされます。 ただし、外部出力ウィンドウを開くことに切り替えることができます。

Procedure:

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)) を押すか、メインメニューから  `ヘルプ | アクションの検索`  を選択します。 開いたポップアップで、  `Registry`  の入力を開始し、対応する項目を選択して `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) を押します。

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

2. 開いたダイアログで、   cidr.debugger.gdb.workaround.windows.forceExternalConsole   と入力し始めます。 ハイライトされた文字列の   値   フィールドをクリックします。

![Windows で外部 GDB コンソールを有効にするレジストリキー](https://resources.jetbrains.com/help/img/idea/2026.3/cl_gdbexternalconsole_windows.png)

## コンパイル時の評価

[Constexpr デバッガー](constexpr-debugger.html)では、評価をステップ実行し、値を調べ、どの  `if constexpr`  ブランチが実行されたかを確認することで、実際に何が起きているのかをコンパイラーの視点から把握できます。 このツールは、コンパイラーが行っていることを正確に理解し、問題をより速く修正するのに役立ちます。

## デバッガーログの記録を有効化

開始しないセッションなどのデバッガーの問題を診断する必要がある場合、CLion は詳細なデバッガー診断を IDE ログに書き込むことができます。 その後、ログには GDB、LLDB、および [DAP](dap-support.html) セッションについて、IDE とデバッガーバックエンド間のすべてのメッセージトラフィックが含まれます。

Procedure: デバッガー診断をログに記録

1. メインメニューから  `ヘルプ | 診断ツール | デバッグログ設定…`  を選択します。

2. カスタムデバッグログ構成   ダイアログで、次のカテゴリを単独の行に追加します:

```
com.jetbrains.cidr.execution.debugger
```

![CLion デバッガーログカテゴリが単独の行に追加された、カスタムデバッグログ構成ダイアログ。](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_log_settings.png)

このカテゴリは  `DEBUG`  レベルで記録されるため、レベルサフィックスを追加する必要はありません。

3. デバッグセッションを開始して問題を再現します。

4. `idea.log`  を [ログディレクトリ](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#logs-directory) で確認します。

ログ記録を停止するには、ダイアログを再度開いてカテゴリを削除します。

## See also

### ハウツー

[Quick Tutorial: Configure CLion on Windows](quick-tutorial-on-configuring-clion-on-windows.html) [チュートリアル: macOS に CLion を設定する](quick-tutorial-on-configuring-clion-on-macos.html)

### 外部リンク

[CLion Debugging Beyond the Basics - Part 3 - Beyond Local](https://blog.jetbrains.com/clion/2021/05/clion-debugging-beyond-the-basics-part-3-beyond-local)

