在 Windows 下安装 Rust 环境

安装 C++ 生成工具

在 Windows 操作系统中，Rust 开发环境需要依赖 C/C++ 编译环境，如果你直接去 Rust 官网下载 rustup-init.exe 并使用默认安装的话，它会让你安装 Visual Studio。因为一些原因我们可能不想安装 Visual Studio 但还是想要安装 Rust，那么此时我们只需要安装 Microsoft C++ 生成工具即可。

推荐在官网下载，地址：Microsoft C++ 生成工具 - Visual Studio。

image-20230527124222050

点击 下载生成工具，下载完成后并打开安装。勾选 使用 C++ 的桌面开发 之后会自动勾选5个项目，我们只需要保留下面两个项目即可。

  • MSVC v143 - VS 2022 C++ x64/x86 生成工具
  • Windows 11 SDK (10.0.22000.0)

关于安装位置自行更改即可。

下载 Rust

推荐在官网下载，地址：安装 Rust - Rust 程序设计语言 (rust-lang.org)。

根据你的 Windows 操作系统位数下载对应的文件。

image-20230527125445522

自定义安装目录

我们在不做任何配置的情况下 Cargo 和 Rustup 会默认安装在 C 盘下，但有时我们会出于一些原因想安装在其他位置中。

新建目录

在需要安装的目录下分别建两个文件夹 .cargo 和 .rustup。这里我就在 D:\Env\Rust 中新建，如图。

image-20240804141345938

配置

关于系统环境变量和用户环境变量的区别，请看： 简谈 Windows 的环境变量以及用户变量与系统变量的区别

打开环境变量，在用户变量一栏中新建如下变量：

  • 名为 CARGO_HOME 值为 D:\Env\Rust\.cargo 的变量

image-20240804142237735

  • 名为 RUSTUP_HOME 值为 D:\Env\Rust\.rustup 的变量

image-20240804142341094

然后一路确定，保存即可。

也可以使用命令的方式添加。

1
2
3
# 若路径有空格时可用""括起来
setx CARGO_HOME D:\Env\Rust\.cargo
setx RUSTUP_HOME D:\Env\Rust\.rustup

image-20240804142811282

关于 setx 命令，请看：CMD 的 set 与 setx 命令。

配置 Rustup 镜像

由于众所周知的原因，在国内安装 Rust 会很慢，所以这里我们要先配置一下 rustup 镜像以加速下载。

同上面的配置一样，我们继续在用户变量一栏中新建变量（过程我就不演示了）。

  • 名为 RUSTUP_DIST_SERVER 值为 https://rsproxy.cn 的变量
  • 名为 RUSTUP_UPDATE_ROOT 值为 https://rsproxy.cn/rustup 的变量

为了快速添加，我更推荐使用命令的方式添加。

1
2
3
# 若路径没有空格时可以不用""括起来
setx RUSTUP_DIST_SERVER https://rsproxy.cn
setx RUSTUP_UPDATE_ROOT https://rsproxy.cn/rustup

这里配置的是字节跳动镜像源，地址：RsProxy。

安装 Rust

双击运行 rustup-init.exe，如果你是按照我的教程一步一步来的，那么不出意外你将会看到如下界面。

image-20240804143501533

按 1 默认安装即可。

安装完成后打开一个新的终端，输入以下命令。

1
2
cargo -V
rustc -V

如下图显示即说明安装完成。

image-20240804143910422

配置 Cargo 镜像

为 Rust 的包管理器 Cargo 配置国内源，以加速包的下载和编译过程。上面我们已经自定义了 Cargo 的安装目录，如果你的安装目录和我的一样，那么就在 D:\Env\Rust\.cargo 文件夹中新建名为 config.toml 的文件。其内容如下。

1
2
3
4
5
6
7
8
9
10
[source.crates-io]
replace-with = 'rsproxy-sparse'
[source.rsproxy]
registry = "https://rsproxy.cn/crates.io-index"
[source.rsproxy-sparse]
registry = "sparse+https://rsproxy.cn/index/"
[registries.rsproxy]
index = "https://rsproxy.cn/crates.io-index"
[net]
git-fetch-with-cli = true

这里添加的镜像是字节跳动的国内源。
默认情况下 Cargo 安装在 C:\Users\用户\.cargo 文件夹中。
这里补充一个小细节，在有的文章中说是新建一个名为 config 的文件，而没有 .toml 后缀，这是因为在 Rust 1.39 版本引入了对 .toml 配置文件的支持，并且推荐使用 .toml 格式。但是，如果同时存在有后缀和无后缀的文件，Cargo 将使用无后缀的文件，这是为了保持向后兼容性。
这部分内容在 Rust 的官方文档《The Cargo Book》中的 Configuration 部分有提及。

卸载

打开终端，输入命令：rustup self uninstall。

按 y 确认即可卸载。

接下来耐心等待即可，出现如下提示则证明卸载完成。

image-20240804145025600

测试是否删除干净，输入下面命令。

1
2
cargo -V
rustc -V

如果出现如图输出，则证明 Rust 卸载成功。

image-20240804145112692

更新 Rust

有时我们需要更新一个 Rust，这里我们使用官方推荐的更新方式，使用下面的命令：

1
rustup update stable

此命令会更新最新的稳定的 Rust。

检查并更新 rustup 工具本身，可以使用以下命令：

1
rustup self update

这个命令会从 Rust 的官方站点下载最新的 rustup 工具，并将其安装到本地系统上。如果你已经安装了 rustup，但是不确定它是否是最新版本，可以使用该命令检查并更新。