Rust 在国内开发环境正确的安装步骤

在国内安装 Rust 开发环境，很多同学发现安装异常的慢，安装一个语言需要30分钟甚至更久，另外开发过程中，cargo 下载crate 包也是非常缓慢，程序员哪能受得了这种气，其实新同学是因为初来乍到，没有经验，直接官网下载安装脚本，直接执行安装了，特别是在 Windows 下，双击完事，殊不知，执行安装文件的过程中，还需要联网下载几个几十M的文件，区区几个小文件就花费了很长的时间。此文为了实现快速下载，我们安装之前需使用国内一些镜像源，再正式去安装，这样安装和开发过程都才会飞快。以下是详细的安装步骤和顺序：

1. 安装 Rustup 和 Rust

Rustup 是 Rust 的版本管理工具，借助它能方便地安装和管理 Rust 工具链。

Windows 系统

步骤一：下载安装脚本

访问 Rust 官方网站的安装页面（https://www.rust-lang.org/tools/install ），下载 rustup-init.exe 安装程序。

步骤二：配置国内镜像源

在运行安装程序之前，需要配置环境变量以使用国内镜像源。可以通过以下步骤设置：

• 右键点击 “此电脑”，选择 “属性”。

• 点击 “高级系统设置” -> “环境变量”。

• 在 “系统变量” 中新建一个变量，变量名：RUSTUP_DIST_SERVER，变量值：https://mirrors.ustc.edu.cn/rust-static；再新建一个变量，变量名：RUSTUP_UPDATE_ROOT，变量值：https://mirrors.ustc.edu.cn/rustup。

注： 有些同学反馈，环境快速安装完成了，在开发的过程中，发现100G 的 C 盘，很快就占满了，埋怨 Rust 太耗空间，影响到了操作系统的使用，其实是因为 Rust 的 .cargo .rustup 这两个文件夹默认指定在 C 盘下了，开发调试的时候，过程文件全部都放在那两个文件夹下面了，我们可以自定义指定路径，方法如下：

• .cargo 挪窝，右键点击 “此电脑”，选择 “属性”，点击 “高级系统设置” -> “环境变量”，在 “系统变量” 中，点击 “新建”，变量名输入 CARGO_HOME，变量值输入你刚刚移动后的 .cargo 文件夹的路径，如 D:\rust.cargo （这个路径一定预先新建好，建议放到空间充足的大分区内）。

• rustup 挪窝，右键点击 “此电脑”，选择 “属性”，点击 “高级系统设置” -> “环境变量”，在 “系统变量” 中，点击 “新建”，变量名输入 RUSTUP_HOME，变量值输入你刚刚移动后的 .rustup 文件夹的路径，如 D:\rust.rustup （（这个路径一定预先新建好，建议放到空间充足的大分区内）。

  步骤三：运行安装程序

  运行下载好的 rustup-init.exe，按照提示进行安装。安装过程中，选择默认选项即可。

Linux 和 macOS 系统

步骤一：配置国内镜像源

打开终端，执行以下命令设置环境变量：

export RUSTUP_DIST_SERVER="https://mirrors.ustc.edu.cn/rust-static"
export RUSTUP_UPDATE_ROOT="https://mirrors.ustc.edu.cn/rustup"

如果想让这些设置在每次启动终端时都生效，可以将上述命令添加到 ~/.bashrc（对于 Bash）或 ~/.zshrc（对于 Zsh）文件中。

步骤二：运行安装脚本

在终端中执行以下命令下载并运行 Rustup 安装脚本：

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

按照提示完成安装，安装完成后，需要重新加载环境变量：

source $HOME/.cargo/env

2. 验证安装

安装完成后，在终端中执行以下命令验证 Rust 是否安装成功：

rustc --version
cargo --version
rustup --version

如果能正确输出版本信息，则说明安装成功。

3. 配置 Cargo 国内镜像源

Cargo 是 Rust 的包管理工具，配置国内镜像源可以加快依赖下载速度。

• 步骤一：创建或编辑配置文件

  在用户主目录下创建或编辑 .cargo/config.toml 文件（如果文件不存在则创建）。

• 步骤二：添加镜像源配置

  在 config.toml 文件中添加以下内容：

[source.crates-io]
replace-with = 'ustc'
[source.ustc]
registry = "https://mirrors.ustc.edu.cn/crates.io-index"
[http]
proxy = "http://127.0.0.1:7890"
check-revoke = false
[https]
proxy = "http://127.0.0.1:7890"
check-revoke = false

以上配置使用了中国科学技术大学的镜像源。如果你想使用其他镜像源，如阿里云镜像源，可以将上述配置修改为：

[source.crates-io]
replace-with = 'aliyun'
[source.aliyun]
registry = "https://mirrors.aliyun.com/crates.io-index"
[http]
proxy = "http://127.0.0.1:7890"
check-revoke = false
[https]
proxy = "http://127.0.0.1:7890"
check-revoke = false

4. 测试镜像源

创建一个新的 Rust 项目并尝试下载依赖来测试镜像源是否生效：

cargo new test_project
cd test_project
cargo build

如果依赖下载速度明显加快，说明镜像源配置成功。

通过以上步骤，你就可以在国内快速、顺利地安装和配置 Rust 开发环境。