前言

这是Rust开发单片机系列教程的第一个教程。此教程会为大家演示如何配置一个基础的Rust开发环境。 let me see reaction image 需要说明的是,与传统是同C/CPP语言开发单片机不同,Rust开发单片机只需要配置一个开发环境即可。不再需要使用诸如Keil-uVision5IAR, SES, MRS/MRS2, STM32CubeIDEIDE

本教程主要演示如何在Windows平台配置开发环境,如果你是Linux用户,配置会更简单,有差异的步骤会单独指出,方便一个教程兼容多个平台。

准备清单

项目说明
操作系统Windows 为主,Linux 可参考差异说明
编辑器VSCode
编译依赖Visual Studio Community Edition
Rust安装器rustup-init.exe
预期结果终端可以正常执行cargorustcrustup

对于已经尝试过Rust开发,觉得Rust并没有帮你解决问题,也没有达到预期效果,想要卸载Rust的用户,只需要打开终端,输入以下命令,再输入y,按下Enter,便可卸载Rust

rustup self uninstall

rustup self uninstall confirmation

此次需要安装的软件如下:

若是你的电脑上已经存在了部分软件,例如VSCodeVisual Studio Community Edition,那就太好了,你只需要做很少的工作即可开始Rust开发,不仅是开发MCU等。

VSCodeVisual Studio Community Edition的安装不会难住任何人,特别是本频道的各位,所以大家点击上方链接,直接跳转到下载页进行安装即可。


安装 VSCode 和 Visual Studio Community Edition

看到这一行的时候,我会默认你已经安装了VSCodeVisual Studio Community Edition,从这一段之后便是正式的配置环节。

第一步,配置VSCode,这一步最好是新建一个profile来作为rust开发环境,不要与其他的工具链混用。之后再安装以下插件即可。

  • rust analyzer
  • even better toml
  • dependi

第二步,打开Visual Studio Installer,这个软件是用于安装Visual Studio Community Edition的。

确保你安装了以下这些组件。以截图形式给出,自行对照安装即可。

打开Visual Studio Installer之后,点击红色箭头指示的ModifyVisual Studio Installer modify button

在弹出的窗口里确保红色箭头指示的这些组件被成功安装。

Visual Studio desktop development workload selected

Windows SDK component selected in Visual Studio Installer

至此,已经完成2/3的进度了。


安装 Rust

第三步,安装Rust

由于默认安装会将整个Rust工具链安装到C盘,考虑到部分开发者的C可能甚至没有512GB,故先配置环境变量,便于将Rust工具链安装到其他空间充裕的盘符。

教程里演示的是安装到D盘,先在D盘新建两个目录,用于安装Rust工具链。


配置环境变量

具体操作步骤:新建文件夹/目录,命名为RUST,进入RUST文件夹/目录,新建两个目录,分别为.cargo.rustup

# variable name
RUSTUP_HOME
# variable value
D:\RUST\.rustup

RUSTUP_HOME environment variable path

# variable name
CARGO_HOME
# variable value
D:\RUST\.cargo

CARGO_HOME environment variable path

环境变量配置完成。

双击打开rustup-init.exe

可以在终端里看到红色箭头指示的内容,则说明Rust工具链安装的环境变量配置成功。

rustup-init startup options

随后,输入2,按下Enterrustup customize installation menu 紧接着会弹出确认信息,继续按Enterrustup host triple confirmation 随后会弹出确认toolchain选择信息,此时输入nightly并且按下Enterrustup toolchain selection prompt 随后还会确认profile,按Enter即可。 rustup profile selection prompt 最后会询问是否要modify环境变量,也就是采用我们之前配置的环境变量。输入y并且按下Enterrustup PATH modification prompt 按下Enter之后,会再次出现以下提示信息。 rustup installation confirmation screen 此时,只需要按下Enter即可。 rustup installation progress 看到终端里的Rust is installed now. Great!,则说明此次安装圆满完成。 Rust installed successfully message

以上步骤对于新手来说,可能稍显繁琐,但这是实践下来,个人认为比较满意的安装方式。

如果你使用的是Linux,只需要你安装了gcc,然后,直接在官网复制安装命令,进行安装即可,环境配置的操作是一样的,无非是将其写进.bashrc,但大多数时候默认安装即可。

至此,Windows平台的Rust开发环境就算搭建完成了,这个环境可以理解为一个基础环境。你可以选择用其开发桌面应用、命令行工具,也可以在其基础上添加一些工具,用来做嵌入式开发。


资料推荐

若想要进一步学习Rust,也可以给大家推荐一些资源。

rust_book

rust_book

cool

常见问题

  • 终端找不到cargo时,重新打开终端,或检查CARGO_HOMEPATH是否已经生效。
  • 安装卡住时,优先确认网络代理、杀毒软件和系统权限是否影响下载。
  • 后续开发某个芯片平台前,还需要继续安装对应平台的target、烧录工具和调试工具。

Discussion

评论与讨论

使用 GitHub 登录后,可以在这里留言、提问或补充文章内容。