# 任意の実行可能ファイルをデバッグする

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

You can use CLion to debug an executable that was built elsewhere using any build system. この記事では、アプリケーションに応じて選択できる 3 つのオプションについて説明します。 Whichever one you use, all the CLion debugging facilities will be fully available for your code. 要件は、バイナリにデバッグシンボルが含まれていて、ソースファイルが手元にあることです。

## オプション 1: 実行中のプロセスにアタッチする

最も簡単な解決策は、デバッガーをすでに実行中のプロセスに接続することです。 これは、さまざまなサービスのように、無期限に実行できるアプリケーションに適しています。

> **Tip:**
> 一般的な情報については、 [プロセスに接続](attach-to-process.html)を参照してください。

Procedure:

1. メインメニューから  `ファイル | オープン`  を選択し、ソースファイルを開きます。

2. [ブレークポイント](using-breakpoints.html)を設定し、プロセスにアタッチした  後 にブレークポイントがヒットすることを確認します。

3. プロセスを起動します。 これは、IDE の外部で、または [内蔵ターミナル](terminal-emulator.html)（  `表示 | ツールウィンドウ | ターミナル`  または `Alt+F12` (Windows), `⌥ F12` (macOS), `⌥ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ T` (macOS System Shortcuts), `Alt+F12` (XWin), `Alt+F12` (GNOME), `Alt+F12` (KDE), `Alt+F12` (Emacs), `Alt+F12` (Sublime Text), `⌥ F12` (Sublime Text (macOS)), `⌥ F12` (Xcode), `Ctrl+Alt+1` (Visual Studio), `⌘ ⌃ 1` (Visual Studio (macOS)), `Ctrl+Alt+1` (ReSharper), `⌘ ⌃ 1` (ReSharper (macOS)), `Alt+F12` (QtCreator), `⌥ F12` (QtCreator (macOS)), `Alt+F12` (NetBeans), `Alt+F12` (Eclipse), `⌥ F12` (Eclipse (macOS)) ）を使用して実行できます。

4. In CLion, call   実行 | プロセスにアタッチ   from the main menu or press `Ctrl+Alt+F5` (Windows), `⌥ ⇧ F5` (macOS), `⌥ ⇧ F5` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ F5` (macOS System Shortcuts), `Ctrl+Alt+5` (XWin), `Ctrl+Alt+5` (GNOME), `Ctrl+Alt+5` (KDE), `Ctrl+Alt+F5` (Emacs), `Ctrl+Alt+F5` (Sublime Text), `⌥ ⇧ F5` (Sublime Text (macOS)), `⌥ ⇧ F5` (Xcode), `Ctrl+Alt+P` (Visual Studio), `⌘ ⌥ P` (Visual Studio (macOS)), `Ctrl+Alt+F5` (ReSharper), `⌃ ⌥ F5` (ReSharper (macOS)), `Ctrl+Alt+F5` (QtCreator), `⌥ ⇧ F5` (QtCreator (macOS)), `Ctrl+Alt+F5` (NetBeans), `Ctrl+Alt+F5` (Eclipse), `⌥ ⇧ F5` (Eclipse (macOS)).

5. In the list of entries, search for your process:

![実行中のプロセスへのアタッチ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_exteranlexe_attach.png)

6. デバッガーが正常に接続されると、通常どおりデバッグできるようになります。 詳細については、「 [デバッグ](debugging-code.html)」セクションを参照してください。

![実行中のプロセスのデバッグ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_externalexe_attached.png)

7. 終了したら、  `実行 | 停止`  を呼び出すか、ツールバーまたは [デバッグツールウィンドウ](debug-tool-window.html) で ![中断](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.suspend.svg) をクリックして、プロセスから切り離します。

## オプション 2: 偽の CMake プロジェクトをデバッグする

もう 1 つのオプションは、基本的な CMake プロジェクトを作成し、 [CMake アプリケーション](run-debug-configuration-application.html)構成を使用して外部実行可能ファイルをデバッグすることです。

Procedure:

1. 新規プロジェクト   を [ようこそ画面](welcome-screen.html) でクリックするか、メインメニューから  `ファイル | 新規プロジェクト`  を選択してください。

2. いずれかの C/C++ テンプレートを選択し、プロジェクト名を指定して、   作成   をクリックします。

![偽の CMake プロジェクトを作成する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_externalexe_fakeprj.png)

3. CLion は、デフォルトの実行/デバッグ構成を含むスタブプロジェクトを生成します。 その構成を使用するか、   CMake アプリケーション   テンプレートから新しい構成を作成できます。

![デフォルトの CMake 構成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_externalexe_fakeprj_config.png)

4. `実行 | 実行構成の編集​`  に進みます。 構成設定で、実行可能ファイルのパスを設定します。

![CMake 構成でカスタム実行可能ファイルを設定する](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_externalexe_fakeprj_config_exe.png)

設定を適用します。

5. メインメニューから  `ファイル | オープン`  を使用してバイナリのソースを開きます。

> **Note:**
> ソースをプロジェクトフォルダーにコピーする必要はありません。

6. ソースを移動し、 [ブレークポイント](using-breakpoints.html)を設定します。

![外部ソースのブレークポイント](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_externalexe_fakeprj_breakpoints.png)

CLion will show warnings that the files don't belong to the project. ビルドシステムとして CMake を使用していないため、これらの警告は無視してかまいません。

7. 準備ができたら、手順 4 で設定した構成のデバッグセッションを開始します。

![偽の CMake プロジェクトからの外部実行可能ファイルのデバッグ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_externalexe_fakeprj_debugging.png)

> **Tip:**
> 必要に応じて、プロジェクトのツールチェーン設定で [使用可能なデバッガーを切り替](configuring-debugger-options.html#select-debugger)えることができます。

## オプション 3: カスタムビルドアプリケーションをデバッグする

より本格的な代替手段として、CLion の [カスタムビルドターゲット](custom-build-targets.html)を使用します - さまざまな種類の C/C++ アプリケーション向けに、ビルドと実行/デバッグを設定する方法です。 [デバッグ](#custom-app)、またはビルド、クリーン、デバッグの [完全なチェーン](#custom-target)を構成できます。

Procedure: デバッグ用のカスタム構成を作成する

1. Open the source files in CLion using  `ファイル | オープン`  from the main menu.

2. ソースを移動し、 [ブレークポイント](using-breakpoints.html)を設定します。

3. メインメニューで、  `実行 | 実行構成の編集​`  に移動し、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして、テンプレートのリストから [カスタムビルドアプリケーション](custom-build-application.html)を選択します。

4. まず、実際のビルドが実行されない場合でも、ビルドターゲットを指定する必要があります。 これが必要なのは、ビルドターゲットがデバッガーの取得元のツールチェーンを定義するためです。

カスタムビルドターゲットを構成する   をクリックします。 開いたダイアログで、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして新しいターゲットを追加します。 ターゲットの名前を指定し、他のフィールドは空のままにします。

![偽のカスタムビルドターゲットの作成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_externalexe_customtarget_fake.png)

> **Note:**
> If you want CLion to perform build/clean for you, configure a proper build target as described [below](#custom-target).

ターゲットを保存して、構成設定に戻ります。

5. * ターゲット​ フィールドで作成したビルドターゲットを選択します。 CLion は Edit Configurations ダイアログの下部に警告を表示します。 デバッグの目的で、この警告は無視できます。

* 実行可能ファイル フィールドにアプリケーションバイナリを指定します。

![カスタム実行 / デバッグ構成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_externalexe_customconfig.png)

6. Save the configuration and start a debug session:

![カスタムビルドアプリケーションのデバッグ](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_externalexe_customconfig_debug.png)

Procedure: カスタムビルドターゲットを構成する (さらに)

デバッグ用のカスタム構成に加えて、プロジェクトのビルド / クリーンツールをセットアップすることもできます。

Meson ビルドシステムを例として取り上げます。

1. `設定 | ビルド、実行、デプロイ | カスタムビルドターゲット`  に移動し、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) をクリックして新しいターゲットを追加します。

2. ビルド / クリーンツールを設定します。 必ず適切な   作業ディレクトリ   を指定してください。

この例では、   ビルド   ツールの名前は   Meson_build   であり、  `buildir`  ディレクトリの  `meson compile`  を呼び出します。

![カスタムビルドツール](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_externalexe_custombuildtool.png)

> **Tip:**
> ターゲットを保存した後、   プロジェクトのビルド   /   プロジェクトの再ビルド   アクションの使用を開始できます。

3. `実行 | 実行構成の編集​`  に移動し、   ターゲット​   フィールドで新しく作成されたカスタムターゲットを選択します。

![ビルドによるカスタム構成](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_externalexe_custombuild_config.png)

4. この構成をデバッグすると、最初に指定されたツールを使用してプロジェクトがビルドされます。

## See also

### ハウツー

[Custom build targets and applications](custom-build-targets.html) [Compilation database projects](compilation-database.html)

### プロシージャ

[Debugging](debugging-code.html) [Debugger options](configuring-debugger-options.html) [Attaching to a process](attach-to-process.html)

