快速入门指南
刚接触 RustRover? 此指南将帮助您探索 IDE 的工作区与功能,并尝试 Rust 开发过程中的各个主要方面。
1. 打开或创建 Rust 项目
您有三种方法可以开始处理 Rust 项目。
创建一个新的 Cargo 项目
启动 RustRover。
要创建新项目,请执行以下任一操作:
在欢迎屏幕上,点击 新建项目。
从主菜单中选择 。
在主窗口标题栏中点击 Project 小部件,并选择 新建项目。

在左侧窗格中,请确保选中 Rust。
请指定项目位置和名称。
请指定 Rust 工具链和标准库的位置。
如果工具链和标准库已安装,RustRover将自动检测到它们。 否则,系统将建议您下载 Rustup。

请选择所需的 项目模板 ,然后点击 创建。

打开本地 Cargo 项目
在主菜单中,进入 . 在文件选择器中,选择包含根 Cargo.toml 文件(或 Cargo.toml 本身)的目录目录,然后点击 已打开:

在打开的对话框中,选择 作为项目打开。

首次打开项目时,RustRover 会提示您确认是否认为它是安全的。

请点击 信任项目 如果您确定项目没有威胁并且您希望启用所有 IDE 功能。 如果您有任何疑问,请选择 以安全模式预览。 如需更多信息,请参阅 项目安全。

从 VCS 克隆存储库
在主菜单中,进入 或在欢迎屏幕上点击 从 VCS 获取。
请指定仓库 URL 和目标目录。 点击 克隆:

2. 探索工作区和功能
RustRover 的功能集旨在简化 Rust 开发流程。让我们更深入地了解其功能优势。 让我们仔细看看它提供的功能。
代码分析与错误报告
为了帮助您应对代码中的错误与不一致问题,RustRover 提供 内置检查 ,并与 外部 linter集成。
有关所有检测到的问题的摘要,请使用编辑器右上角的 检查 小部件。 要查看详细信息,请点击小部件并参考 问题工具窗口 (或选择 ):

检查
检查会对当前编辑器中打开的所有文件即时运行。 您还可以 手动运行检查以用于更大作用域。 要查看检查结果,请使用 “问题”工具窗口 ()。
RustRover 会在可能的情况下建议 快速修复与意图。 快速修复以红色灯泡标记(
),用于处理错误。 意图以黄色灯泡标记(
),用于建议可能的增强和优化内容。
应用快速修复/意图
如果检查检测到您的代码中的问题,您可以在编辑器中快速应用修复。 将文本光标放置在高亮的代码部分并按 Alt+Enter。

欲了解更多信息,请参阅 代码检查。
外部 linter
除了 内置检查集外,RustRover 还使用外部 linter 验证您的代码。 您可以在 Cargo Check 和 Clippy 之间进行选择,并 按照自己的喜好预设调用方式。
启用外部 linter 实时运行后,您可以使用 变量生存期可视化功能 :当 linter 报告借用检查器错误时,只需点击变量,即可查看其生存期的可视化展示。

有关更多信息,请参见 外部 linter。
格式化
您可以轻松地使用 IDE 的内置格式化器 或 Rustfmt (默认启用)来格式化代码。
启用(或禁用)Rustfmt 以代替内置格式化工具
按 Ctrl+Alt+S 打开设置并导航到 。
要启用 Rustfmt,选中 请使用 Rustfmt 替代内置格式化程序 复选框。 若要禁用 Rustfmt,请清除复选框。

点击 确定 以应用更改。
重新格式化文件
在编辑器中打开您想要重新格式化的文件。
按 Ctrl+Alt+Shift+L 或选择 。
在 对话框中,选择必要的额外选项并点击 。

Cargo 工具窗口
Cargo 工具窗口 Cargo 工具窗口旨在帮助您处理 Cargo 任务。 默认情况下,它被固定到工具窗口栏。 您可以通过点击侧边栏上的窗口指示器 来显示或隐藏它(或者,从主菜单中选择 )。

Cargo 工具窗口提供便捷方式访问 Rustfmt 与 外部 linter 等常用 Rust 工具。 它还可让您快速 调用 Cargo 命令、 重新加载项目模型以及 运行项目目标。
欲了解更多信息,请参阅 Cargo 工具窗口。
在 Playground 中共享代码
您可以在不离开编辑器的情况下在 Rust Playground 中共享您的代码。
在 Playground 中共享
选择您想要分享的代码片段(否则,IDE 将复制整个文件)。
右键点击并选择 。
RustRover 将创建一个 GitHub Gist 并显示一个包含 playground 链接的通知弹窗。

3. 构建并运行
使用 构建 操作编译您的代码,并使用 运行 执行它。 执行这些操作有几种方法:
构建/运行 Rust 代码
要构建或运行特定的 target,请打开 Cargo 工具窗口 ( )并双击该 target。

要从特定的入口点运行,请在编辑器中找到它,在边栏中点击
,然后选择 运行:

要运行特定的文件或模块,打开 Project 视图,右键点击所需的文件或模块,然后选择 运行:

如果您想使用 预定义配置 (带有自定义参数和设置)构建或运行代码,请在主工具栏的切换器中选择它,并执行以下操作:
点击
构建 (Ctrl+F9)
点击
运行 (Shift+F10)

您始终可以通过 使用 Cargo 命令 构建/运行代码。
欲了解更多信息,请参阅 构建与运行。
4. 调试
RustRover 提供功能齐全的调试器,支持 断点、 变量监视、 单步执行、 内存与反汇编视图及其他实用功能。
开始调试会话
要从特定的入口点开始调试,请在编辑器中找到它,点击装订区域处的
,然后选择 调试:

要使用 预定义配置 (包含自定义参数和设置)调试代码,请在主工具栏的配置切换器中选择它,然后点击
:

您始终可以通过 运行 Cargo 命令 启动调试会话。
有关更多信息,请参见 启动调试器会话。
从这些指南中学习如何执行基本的调试操作:

有关更多信息,请参见 调试部分。
5. 测试
您可能会通过测试、 文档测试和/或基准测试来支持您的代码。 以下是运行它们的几种快捷方式:
运行测试、文档测试或基准测试
要运行单个测试或 doctest,请在编辑器中打开它,点击边栏中的
,然后选择 运行:

要运行测试/基准目标,请打开 Cargo tool window ( ),然后双击目标:

您始终可以通过 使用 Cargo 命令 运行测试。
运行工具窗口将自动打开,并显示结果:

有关更多信息,请参见 测试部分。
6。 使用覆盖率运行
RustRover 允许您查看代码覆盖率统计信息。
运行代码覆盖率
要获取代码覆盖率统计信息,请执行以下操作:
定位所需的入口点,点击
,并选择 使用覆盖率运行:

请在项目视图中定位必要的文件,右键点击并选择 使用覆盖率运行:

如果您想运行一个 预定义配置 (带有自定义参数和设置),请在主工具栏的切换器中选择它,然后按
并选择 使用覆盖率运行: 
Coverage 工具窗口 () 将会打开,并自动显示结果:

有关更多信息,请参见 代码覆盖率。
调整 RustRover 设置
您可以根据需求自定义 RustRover 的功能。 以下是部分可用的自定义项:
