在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) 来启动一个调试会话。

更多调试功能

。。。