在CLion中调试Rust代码

-- 发表于十月9，2019通过玛丽娜·卡拉什娜

我们将整个博客投入到IntelliJ Rust已有一段时间了。在本文中，我们将仔细研究该CLion插件在调试Rust应用程序时需要做些什么。

首先，我们将直接进入调试会话(debug session)以了解基础知识，然后详细探讨调试器设置和其他选项。

如果你想得到更多信息，请移步到rust插件的快速教程和CLion的web应用程序调试。

开始之前

首先，请确保您的项目已完全加载。如果建立索引已经完成，并且Cargo工具窗口显示了工作区的所有模块和目标(all the modules and targets)，那么您就已完全加载。

在Windows上, 进入到 设置|构建，执行，部署|工具链(Settings | Build, Execution, Deployment | Toolchain) 并将Cygwin或MinGW设置为您的工作环境。然后，运行命令rustup toolchain list并检查第一行：它应该是与调试器的位数相匹配的gnu版本之一。例如，如果您使用的是MinGW（32位），则默认工具链应为i686-pc-windows-gnu。如果您使用的是MinGW64，则应为x86_64-pc-windows-gnu。您可以通过运行命令rustup default <toolchain_name>来设置适当的工具链。

如何开始调试

如果我们要调试无输入参数的测试或目标，最快的方法是使用快捷菜单。

让我们选择一个要调试的测试，在代码中放置几个​​断点，然后单击测试名称旁边的Debug图标：

该插件将调用cargo test以获取带有调试信息的未优化二进制文件，然后将其在调试器下启动。

当我们的测试达到第一个断点时，“调试”窗口将自动弹出。它是围绕堆栈跟踪和线程组织的：我们可以从一个线程切换到另一个线程(threads)，然后上下移动框架(Frames)。

在右侧，我们具有当前范围内的变量。我们可以通过在该窗格中键入右键来进行搜索，然后展开数据结构的子节点。

实际上，我们不必在每个步骤中都深入“变量”窗格，因为这些值也与变量一起内联显示：

在“调试”窗口的顶部，我们有一些按步走的按钮，例如Step Over（F8），Step Into（F7）和Force Step Into（在Windows / Linux上为Shift + Alt + F7，在macOS上为⇧⌥F7）。当我们想进入一个源代码不可访问的函数时，后者很有用。在这种情况下，“强制进入”会直接跳至反汇编：

现在，我们知道了如何逐步检查变量，接下来让我们停止会话并查看设置。

切换调试器和渲染器

我们可以选择IntelliJ Rust将采用的调试器：

• 在macOS和Linux上，选项是捆绑的LLDB(Bundled LLDB)，捆绑的GDB(Bundled GDB)或自定义GDB二进制文件。
• 在Windows上，我们可以在用于MinGW的捆绑GDB(Bundled GDB)，Cygwin GDB(Bundled GDB)或自定义GDB之间进行选择。

CLion的web帮助文档中列出了支持的版本。

除了调试器本身，我们还可以切换在“变量”窗格中显示Rust类型时将使用的渲染器：

无渲染器(No renderers)：此选项禁用显式渲染，仅本地保留GDB或LLDB提供的类型支持。由于Rust类型格式化程序在当前状态下在调试器中不可用，因此该选项意味着不会渲染不同于 C/C ++ 的类型。

Rust编译器的渲染器(Rust compiler’s renderers)：使用此选项，IntelliJ Rust从标准rustc发行版中获取打印字体，并将其加载到调试器中。

捆绑的渲染器(Bundled renderers)：该插件自己的渲染器是为GDB和LLDB从头实现的，统一了两个调试器的类型表示。这些格式化程序为strings，structs，enums和vectors构建树状视图，使您可以更轻松地查看子元素。

捆绑的渲染器也支持标准库类型如：HashMap,HashSet,Rc,Arc,Cell,Ref等等。

调试一个Cargo命令的配置

让我们回到调试，但是这次我们使用 run/debug 配置。

实际上，在较早的时候我们从快捷菜单开始调试会话时，CLion创建了一个临时的Cargo Command配置，我们可以在切换器中看到该配置为灰色：

临时配置具有完整的功能，但是一次只能配置有限数量的临时配置。因此，如果使用快捷菜单调试许多目标和测试，则只有最后几个相应的配置可用。您可以使用Save…使它们永久化。

要基于同一模板创建另一个配置，请转到“编辑配置”，单击"+"，然后选择“Cargo Command”。

在"Command"字段中使用以下模式:
[run]or[test] [build options] [--] [program arguments]

注意 -- 这个前缀后面跟着额外的空格。它分隔了 输入参数 和 传给Cargo的构建选项。

当我们调试此配置时，插件会从调用 cargo build [build options] 启动， 然后插件会启动 调试 名为[program arguments]的二进制文件。

现在我们会保存此配置。确认选择了它并点击 Debug(Ctrl+Don Windows/Linux,⌃Don macOS) 来启动一个调试会话。

更多调试功能

。。。