# 调试任意可执行文件

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

您可以使用 CLion 调试使用任何构建系统在其他地方构建的可执行文件。 本文介绍了三种选项，可根据应用程序进行选择。 无论使用哪一种选项，所有 CLion 调试功能都将完全适用于代码。 要求是您的二进制文件包含调试符号，并且您手头有源文件。

## 选项 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. 在 CLion 中，从主菜单调用   运行 | 附加到进程   或按 `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. 在条目列表中，搜索您的进程：

![附加到正在运行的进程](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 项目

另一种选项是创建一个基本 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 将显示文件不属于项目的警告。 由于您未使用 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. 使用主菜单中的  `文件 | 打开`  在 CLion 中打开源文件。

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:**
> 如果您希望 CLion 为您执行构建/清理，请按照 [下文](#custom-target) 所述配置一个适当的构建目标。

保存目标并返回到配置设置。

5. * 在 目标 字段中选择创建的构建目标。 CLion 会在 Edit Configurations 对话框底部显示一个警告。 出于调试目的，可以忽略此警告。

* 在 可执行文件 字段中指定应用程序的二进制文件。

![自定义运行/调试配置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debug_externalexe_customconfig.png)

6. 保存配置并启动调试会话：

![调试自定义构建应用程序](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_构建  ，并在  `构建ir`  目录中调用  `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)

