CLion 2025.3 Help

Rust

Rust 插件为 CLion 提供了全面的 Rust 支持。 本指南概述了如何开始的基本步骤。 您可以在 RustRover 文档中找到有关受支持功能的更多信息。

安装 Rust 插件

  1. 请确保您已 购买 Rust 插件

  2. 启动 CLion。 在欢迎屏幕上,点击 插件

    如果您已经打开了一个项目,请转到 设置 (Ctrl+Alt+S) | 插件

  3. 选择 插件市场 标签并搜索 Rust 插件。

    从设置中安装 Rust 插件
  4. 点击 安装 并等待下载完成。

    如果出现提示,请重启 IDE。

插件将会自动激活。 要确认它处于活动状态,请导航到 帮助 | 注册 ,并在左侧窗格中选择 Rust

从许可证对话框激活 Rust 插件

安装 Rust 工具链

要在 Rust 中进行开发,您需要一些基本工具:编译器、包管理器、格式化工具等。 这组工具称为 Rust 工具链。 您还需要 Rust Standard Library

如果您已经打开了一个项目并且缺少 Rust 工具链,您将会在编辑器上方看到通知横幅:

未配置 Rust 工具链的通知
  1. 单击 设置工具链

    或者,打开 IDE 设置(Ctrl+Alt+S )并选择 语言与框架 | Rust

  2. 如果未检测到 Rust 工具链, 工具链版本 将显示 不适用。 要安装 Rust 工具链,请点击 安装Rustup 按钮 – CLion 将尝试使用 Rustup 安装工具链和标准库。

    Rust 工具链设置
  3. 安装完成后,CLion 将自动检测其位置,并填充 工具链版本标准库 路径。

  4. 点击 确定 以应用设置。

打开或创建 Rust 项目

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

创建一个新的 Cargo 项目

  1. 启动 CLion。

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

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

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

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

  2. 在左侧窗格中,请确保选中 Rust

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

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

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

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

打开本地 Cargo 项目

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

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

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

    不受信任的项目

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

从 VCS 克隆存储库

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

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

    克隆一个 repo

探索工作区和功能

此插件的功能集旨在简化 Rust 开发过程。 让我们仔细看看它提供的功能。

语法高亮和代码引用

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

交互式嵌入提示

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

操作

快捷方式

展开宏

Alt+Enter

转到声明

Ctrl+Click

获取 type info

Ctrl+Shift+P

快速文档

Ctrl+Q

快速定义

Ctrl+Shift+I

有关更多信息,请参阅 RustRover 文档

代码分析与错误报告

为了帮助您解决代码中的错误和不一致,插件提供了 内置检查 ,并与 外部静态分析器集成。

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

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

如需更多信息,请参阅 RustRover 文档中的 代码检查外部 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 tool window 旨在帮助您处理 Cargo 任务。 默认情况下,它被固定到工具窗口栏。 您可以通过点击侧边栏上的窗口指示器 Rust 图标 来显示或隐藏它(或者,从主菜单中选择 查看 | 工具窗口 | Cargo)。

Cargo 工具窗口

有关更多信息,请参阅 RustRover 文档

在 Playground 中共享代码

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

在 Playground 中共享

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

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

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

在 Playground 中共享代码

如需更多功能,请参阅 RustRover documentation

构建并运行

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

构建/运行 Rust 代码

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

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

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

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

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

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

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

有关更多信息,请参阅 RustRover 文档

调试

Rust 插件提供了一个功能齐全的调试器——包括 断点变量监控单步执行内存反汇编 视图,以及其他实用功能。

开始调试会话

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

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

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

有关更多信息,请参见 启动/暂停/停止调试会话

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

调试会话

有关更多信息,请参阅 RustRover 文档

测试

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

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

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

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

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

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

测试运行窗口

有关更多信息,请参阅 RustRover 文档

动态分析

该插件为 Rust 代码提供 代码覆盖率分析

运行代码覆盖率

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

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

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

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

    运行带覆盖率的配置

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

覆盖率工具窗口

欲了解更多信息,请参阅 代码覆盖率

如需了解更多有关 Rust 支持的信息,请参考 RustRover 文档联系我们的支持团队

Rust 插件与 RustRover

功能集差异

RustRover

CLion+ Rust plugin

IntelliJ IDEA Ultimate+ Rust plugin

调试器

对于 Linux,LLDB 和 GDB 都可用。 对于 macOS,只有 LLDB 可用。 在 Windows 上,LLDB 支持 MSVC,GDB 支持 GNU。 了解更多

对于 Windows 和 Linux,均可使用 LLDB 和 GDB。 对于 macOS,只有 LLDB 可用。

允许进行片上调试

对于 Windows 和 Linux,LLDB 和 GDB 均可用(需要 本机调试支持 免费插件)。 对于 macOS,只有 LLDB 可用。

分析器

适用于 macOS、Linux 和 WSL

适用于 macOS、Linux 和 WSL

Valgrind Memcheck

适用于 Linux、WSL 和 macOS(10.12 或更高版本)

数据库支持

语言支持

RustRover

CLion+ Rust plugin

IntelliJ IDEA Ultimate+ Rust plugin

Rust

Java、Groovy、Kotlin

C/C++,Objective С/С++

Python

通过 免费插件

JavaScript、TypeScript

HTML、CSS

Sass,SCSS,Less

XML,JSON,YAML,XSLT,XPath

Markdown

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