调试 Python 扩展

CLion 当前不支持混合 Python 和 C/C++ 代码的交叉调试（CPP-5797）。但是，您可以使用以下描述的选项之一，在处理 Python 扩展模块时解决此问题。

为了调试扩展的 C/C++ 代码，您需要使用本机调试器 GDB 或 LLDB，并调试加载脚本并运行应用程序的解释器进程。为此，您可以附加到正在运行的 Python 进程，或者调试正确配置的自定义构建应用程序。

设置断点，并确保在您附加到进程后它们会被命中。
启动 Python 脚本。您可以通过系统终端、CLion 的内置终端，或运行 Python 配置来完成此操作。
从主菜单中调用运行 | 附加到进程或按 Ctrl+Alt+F5。
在条目列表中，搜索与进程的 PID 对应的条目，该条目位于 Native 节点下：
将有两个与进程对应的条目：一个允许使用 Python 调试器附加（用于逐步执行 Python 脚本），另一个允许使用本机调试器附加。请确保选择后者。
调试器成功附加后，您将能够像往常一样调试本机代码。有关更多信息，请参阅调试部分。
完成后，调用运行 | 停止或点击工具栏或调试工具窗口中的以从进程中分离。

作为附加本机调试器的替代方法，您可以在其下启动 Python 解释器。如果您知道调用脚本的确切解释器命令，则可以使用此选项。

您需要创建一个自定义目标，用于重建本机扩展，以及一个自定义构建应用程序配置，该配置将调用自定义目标并使用适当的参数执行 Python 解释器。

在主菜单中，转到运行 | 编辑配置，点击，然后选择自定义构建应用程序。
点击配置自定义构建目标，位于目标字段下方。这将打开设置 | 构建、执行、部署 | 自定义构建目标对话框。
点击以添加新目标并设置目标名称。
选择工具链。 CLion 将使用所选工具链中的调试器。
设置用于构建项目的工具。点击，位于构建字段旁边，然后点击以添加新工具。
您还可以在此处设置用于清理项目的工具。
指定工具的配置。下面的截图说明了使用 pip install -e 的情况：
在编辑工具和自定义构建目标对话框中保存更改，并返回设置运行/调试配置。
指定以下设置：
- 可执行文件 - 提供 Python 解释器的路径。
- 程序参数 - 指定脚本名称以及必要的附加参数。
- 工作目录 - 设置项目根目录的路径。您可以在此处使用宏（）和路径变量。
保存配置后，您可以像往常一样为其启动调试会话：

最后修改日期： 2025年 9月 26日