# CMake デバッグ

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

> **TL;DR**
> CMake 実行可能ファイル  ：バンドル済み、バージョン 3.24.2 以降
>
>
>
> OS  ：macOS / Linux / Windows
>
>
>
> WSL / リモート / Docker ツールチェーン  ：サポートされていません

CLion CMake デバッガーは、 [CMake スクリプト](cmakelists-txt-file.html) のエラーや望ましくない動作を特定・修正するのに役立ちます。

CMake バージョン 3.27 以降では、CLion は [デバッグアダプタープロトコル (DAP)](https://microsoft.github.io/debug-adapter-protocol/) を使用します。 [拡張設定](advanced-settings.html#advanced_cmake)では [Sysprogs の CMake スクリプトデバッガー(英語)](https://sysprogs.com/w/introducing-cmake-script-debugger/)に基づく実装に切り替えることもできます。

> **Note:**
> デバッガーは、CMake 構成ステップでのみ機能します。 実際のプロジェクトのビルドはデバッグされず、デバッグ中の CMake の実行後にプロジェクトモデルが [再ロード](reloading-project.html)されません。

Procedure: 失敗した CMake 生成をデバッグする

1. CMake の生成に失敗した場合は、CMake ツールウィンドウで   デバッグ   ヒントをクリックします。

![CMake ツールウィンドウのデバッグヒント](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_debug_tw_hint.png)

2. CLion がデバッグセッションを開始し、コード内の該当箇所に移動します：

![CMake ツールウィンドウから開始されたデバッグセッション](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_debug_failed_fromhint.png)

Procedure: エディターから CMake デバッグセッションを起動する

> **Note:**
> デバッグセッションを開始する前に、プロジェクトがロード / 再ロードされ、プロジェクト分析が完了するまで待機します。

* 最上位の  `CMakeLists.txt`  を開き、最初のコマンド横のガターアイコンをクリックして、   デバッグ   を選択します：

![ガターから CMake デバッグセッションを開始する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_boost_debug_gutter.png)

この方法でデバッグセッションを起動すると、CLion はタイプ   CMake デバッグ   の一時的な構成を作成します。 今後使用するために [保存し](run-debug-configuration.html#save-as-permanent)、そのタイプの構成をさらに作成することができます。 詳細については、次のセクションを参照してください。

Procedure: CMake デバッグ構成を作成して起動する

1. メインメニューで  `実行 | 実行構成の編集​`  へ移動します。

2. ツールバーの ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックするか、 `Alt+Insert` (Windows), `⌘ N` (macOS), `⌃ N` (IntelliJ IDEA Classic (macOS)), `⌘ N` (macOS System Shortcuts), `Alt+Insert` (XWin), `Alt+Insert` (GNOME), `Alt+Insert` (KDE), `Alt+Insert` (Emacs), `Ctrl+N` (Sublime Text), `⌘ N` (Sublime Text (macOS)), `⌘ N` (Xcode), `Ctrl+N` (Visual Studio), `⌘ N` (Visual Studio (macOS)), `Alt+Insert` (ReSharper), `⌥ Insert` (ReSharper (macOS)), `Alt+Insert` (QtCreator), `Alt+Insert` (QtCreator (macOS)), `Alt+Insert` (NetBeans), `Alt+Insert` (Eclipse), `⌘ N` (Eclipse (macOS)) を押します。 テンプレート一覧から   CMake デバッグ   を選択します：

![CMake デバッグ構成の追加](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_debug_config_add.png)

3. 構成の名前を設定し、必要に応じて [起動前](running-cmake-targets-before-launch.html)ステップを追加します。

4. スイッチャーで新しく作成した構成を選択し、 ![「デバッグ」ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.startDebugger.svg) をクリックするか、 `Shift+F9` (Windows), `⌃ D` (macOS), `⇧ F9` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ D` (macOS System Shortcuts), `Shift+F9` (XWin), `Shift+F9` (GNOME), `Shift+F9` (KDE), `Shift+F9` (Emacs), `Shift+F9` (Sublime Text), `⌃ D` (Sublime Text (macOS)), `⌘ R` (Xcode), `Alt+F5` (Visual Studio), `⌥ F5` (Visual Studio (macOS)), `Alt+F5` (ReSharper), `⌥ F5` (ReSharper (macOS)), `F5` (QtCreator), `⌘ Y` (QtCreator (macOS)), `Ctrl+F5` (NetBeans), `Alt+Shift+D` (Eclipse), `⌘ F11` (Eclipse (macOS)) を押します。

## CMake デバッグ機能

CMake デバッガーには、CLion で使える多くの一般的なデバッグ機能が含まれています。 例: [ブレークポイント](using-breakpoints.html)を設定し、 [コードをステップ](stepping-through-the-program.html)実行し、CMake 変数を [監視](examining-suspended-program.html#watches)し、エディターで [インライン化](examining-suspended-program.html#inline-view)された値を調べることができます。

![デバッグセッションの例](https://resources.jetbrains.com/help/img/idea/2026.3/cl_cmake_debug_session_example.png)

## See also

### チュートリアル

[クイック CMake チュートリアル](quick-cmake-tutorial.html)

### ハウツー

[CMake プロファイル](cmake-profile.html) [ツールチェーン](how-to-create-toolchain-in-clion.html)

### デバッグ

[中断されたプログラムを調べる](examining-suspended-program.html) [起動前に CMake ターゲットを実行する](running-cmake-targets-before-launch.html)

