— 发表于十月 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+D
on Windows/Linux,⌃D
on macOS) 来启动一个调试会话。
更多调试功能
。。。