llms.txt: machine-readable documentation index. Markdown version of this page is also available.

CLion 2026.3 Help

Rust

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

安装 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。

    要开始一个新项目,请执行以下操作之一:

    • 在 CLion 主屏幕上点击 新建 | 项目。

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

    • 如果已经打开了项目,请点击主窗口页眉中的项目微件,然后选择 新项目。

  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

PyCharm Pro+ Rust 插件

调试器

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

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

允许进行片上调试

对于 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

PyCharm Pro+ Rust 插件

Rust

支持

支持

支持

支持

Java、Groovy、Kotlin

支持

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

支持

Python

通过 免费插件

支持

支持

支持

JavaScript、TypeScript

支持

支持

支持

支持

HTML、CSS

支持

支持

支持

支持

Sass,SCSS,Less

支持

支持

支持

支持

XML,JSON,YAML,XSLT,XPath

支持

支持

支持

支持

Markdown

支持

支持

支持

支持

2026年 11月 6日