CLion 2025.2 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 工具链, 工具链版本 将显示 N/A。 要安装 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 文档

Debug

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

开始调试会话

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

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

    从工具栏启动调试
  • 您始终可以通过 运行 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年 9月 26日