RustRover 2025.3 Help

快速入门指南

刚接触 RustRover? 此指南将帮助您探索 IDE 的工作区与功能,并尝试 Rust 开发过程中的各个主要方面。

1. 打开或创建 Rust 项目

您有三种方法可以开始处理 Rust 项目。

创建一个新的 Cargo 项目

  1. 启动 RustRover。

    要创建新项目,请执行以下任一操作:

    • 在欢迎屏幕上,点击 新建项目

    • 从主菜单中选择 文件 | 新建 | 项目

    • 在主窗口标题栏中点击 Project 小部件,并选择 新建项目

      使用 Project 小部件创建一个新项目
  2. 在左侧窗格中,请确保选中 Rust

  3. 请指定项目位置和名称。

  4. 请指定 Rust 工具链和标准库的位置。

    如果工具链和标准库已安装,RustRover将自动检测到它们。 否则,系统将建议您下载 Rustup

    从“新建项目”向导安装 Rustup
  5. 请选择所需的 项目模板 ,然后点击 创建

“新建项目”向导

打开本地 Cargo 项目

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

    打开项目(不是文件)
  2. 在打开的对话框中,选择 作为项目打开

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

    不受信任的项目

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

打开项目

从 VCS 克隆存储库

  1. 在主菜单中,进入 文件 | 新建 | 从版本控制创建项目 或在欢迎屏幕上点击 从 VCS 获取

  2. 请指定仓库 URL 和目标目录。 点击 克隆

    克隆一个 repo

2. 探索工作区和功能

RustRover 的功能集旨在简化 Rust 开发流程。让我们更深入地了解其功能优势。 让我们仔细看看它提供的功能。

语法高亮和代码引用

为帮助您快速阅读和理解 Rust 代码,RustRover 提供高亮显示、 内嵌提示宏展开快速访问文档等功能。

交互式嵌入提示

以下是一些您可能会觉得有用的快捷键:

操作

快捷键

展开宏

Alt+Enter

转到声明

Ctrl+Click

获取 type info

Ctrl+Shift+P

快速文档

Ctrl+Q

快速定义

Ctrl+Shift+I

有关更多信息,请参阅 代码参考信息

代码分析与错误报告

为了帮助您应对代码中的错误与不一致问题,RustRover 提供 内置检查 ,并与 外部 linter集成。

有关所有检测到的问题的摘要,请使用编辑器右上角的 检查 小部件。 要查看详细信息,请点击小部件并参考 问题工具窗口 (或选择 视图 | 工具窗口 | 问题):

代码分析结果:问题工具窗口与检查小部件

检查

检查会对当前编辑器中打开的所有文件即时运行。 您还可以 手动运行检查以用于更大作用域。 要查看检查结果,请使用 “问题”工具窗口视图 | 工具窗口 | 问题)。

RustRover 会在可能的情况下建议 快速修复与意图快速修复以红色灯泡标记(“快速修复”按钮 ),用于处理错误。 意图以黄色灯泡标记(意图按钮 ),用于建议可能的增强和优化内容。

应用快速修复/意图

如果检查检测到您的代码中的问题,您可以在编辑器中快速应用修复。 将文本光标放置在高亮的代码部分并按 Alt+Enter

在编辑器中应用快速修复

    欲了解更多信息,请参阅 代码检查

    外部 linter

    除了 内置检查集外,RustRover 还使用外部 linter 验证您的代码。 您可以在 Cargo CheckClippy 之间进行选择,并 按照自己的喜好预设调用方式

    启用外部 linter 实时运行后,您可以使用 变量生存期可视化功能 :当 linter 报告借用检查器错误时,只需点击变量,即可查看其生存期的可视化展示。

    变量生存期可视化

    有关更多信息,请参见 外部 linter

    格式化

    您可以轻松地使用 IDE 的内置格式化器Rustfmt (默认启用)来格式化代码。

    启用(或禁用)Rustfmt 以代替内置格式化工具

    1. Ctrl+Alt+S 打开设置并导航到 Rust|Rustfmt

    2. 要启用 Rustfmt,选中 请使用 Rustfmt 替代内置格式化程序 复选框。 若要禁用 Rustfmt,请清除复选框。

      启用 rustfmt 替代内置格式化程序
    3. 点击 确定 以应用更改。

    重新格式化文件

    1. 在编辑器中打开您想要重新格式化的文件。

    2. Ctrl+Alt+Shift+L 或选择 代码 | 格式化文件

    3. 文件重新格式化 对话框中,选择必要的额外选项并点击 运行

      文件重格式化对话框

    如需更多信息,请参阅 内置格式化程序Rustfmt

    Cargo 工具窗口

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

    Cargo 工具窗口

    Cargo 工具窗口提供便捷方式访问 Rustfmt外部 linter 等常用 Rust 工具。 它还可让您快速 调用 Cargo 命令重新加载项目模型以及 运行项目目标

    欲了解更多信息,请参阅 Cargo 工具窗口

    在 Playground 中共享代码

    您可以在不离开编辑器的情况下在 Rust Playground 中共享您的代码。

    在 Playground 中共享

    1. 选择您想要分享的代码片段(否则,IDE 将复制整个文件)。

    2. 右键点击并选择 Rust | 在 Playground 中共享

    RustRover 将创建一个 GitHub Gist 并显示一个包含 playground 链接的通知弹窗。

    在 Playground 中共享代码

    3. 构建并运行

    使用 构建 操作编译您的代码,并使用 运行 执行它。 执行这些操作有几种方法:

    构建/运行 Rust 代码

    • 要构建或运行特定的 target,请打开 Cargo 工具窗口 (查看 | 工具窗口 | Cargo )并双击该 target。

      从 Cargo 工具窗口运行目标
    • 要从特定的入口点运行,请在编辑器中找到它,在边栏中点击 执行按钮 ,然后选择 运行

      从侧边栏菜单运行
    • 要运行特定的文件或模块,打开 Project 视图,右键点击所需的文件或模块,然后选择 运行

      从项目视图中的上下文菜单运行文件
    • 如果您想使用 预定义配置 (带有自定义参数和设置)构建或运行代码,请在主工具栏的切换器中选择它,并执行以下操作:

      • 点击 构建按钮 构建 (Ctrl+F9)

      • 点击 执行按钮 运行 (Shift+F10)

      主工具栏上的构建图标
    • 您始终可以通过 使用 Cargo 命令 构建/运行代码。

    欲了解更多信息,请参阅 构建与运行

    4. 调试

    RustRover 提供功能齐全的调试器,支持 断点变量监视单步执行内存与反汇编视图及其他实用功能。

    开始调试会话

    • 要从特定的入口点开始调试,请在编辑器中找到它,点击装订区域处的 运行图标 ,然后选择 调试

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

      从工具栏启动调试
    • 您始终可以通过 运行 Cargo 命令 启动调试会话。

    有关更多信息,请参见 启动调试器会话

    从这些指南中学习如何执行基本的调试操作:

    调试会话

    有关更多信息,请参见 调试部分。

    5. 测试

    您可能会通过测试、 文档测试和/或基准测试来支持您的代码。 以下是运行它们的几种快捷方式:

    运行测试、文档测试或基准测试

    • 要运行单个测试或 doctest,请在编辑器中打开它,点击边栏中的 运行图标 ,然后选择 运行:

      使用侧边栏图标运行测试
    • 要运行测试/基准目标,请打开 Cargo tool window (查看 | 工具窗口 | Cargo ),然后双击目标:

      从 Cargo 工具窗口运行目标
    • 您始终可以通过 使用 Cargo 命令 运行测试。

    运行工具窗口将自动打开,并显示结果:

    测试运行窗口

    有关更多信息,请参见 测试部分

    6。 使用覆盖率运行

    RustRover 允许您查看代码覆盖率统计信息。

    运行代码覆盖率

    要获取代码覆盖率统计信息,请执行以下操作:

    • 定位所需的入口点,点击 执行按钮 ,并选择 使用覆盖率运行

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

      使用边栏菜单运行覆盖率
    • 如果您想运行一个 预定义配置 (带有自定义参数和设置),请在主工具栏的切换器中选择它,然后按 运行图标 并选择 使用覆盖率运行

      运行带覆盖率的配置

    Coverage 工具窗口 (视图 | 工具窗口 | 覆盖率) 将会打开,并自动显示结果:

    覆盖率工具窗口

    有关更多信息,请参见 代码覆盖率

    调整 RustRover 设置

    您可以根据需求自定义 RustRover 的功能。 以下是部分可用的自定义项:

    最后修改日期: 2025年 12月 5日