记Windows 11环境Rust下载安装配置流程

记Windows 11环境Rust下载安装配置流程

本次安装的是Rust 1.90.0（1159e78c4 2025-09-14），使用的IDE是RustRover 2025.2.3

一、Rustup下载

按我的理解，这个工具类似于Steam，Rust则是你要安装的游戏，你可以在这个下载器命令行界面进行对Rust的镜像源、安装位置配置。

在Rust官网链接下载Rustup下载器。

 

 

二、Rust安装前环境配置

Crates.io是Rust的包注册中心，地位等同于Python的PyPI，就是用来安装或者发布库的，用过Python的应该很好理解这一点；

Cargo是Rust的包管理器，地位等同于Python的pip，是下载安装包的；

Crate意思就是包，跟Python里的Package是一样的；

Cargo.toml就是声明项目所依赖的外部库，跟Python的requirements.txt/pyproject.toml类似；

另外，Rust的Rustup是一个较为独特的工具，可以靠它来进行版本管理、工具链更新、编译等功能，这是C++、Python所不具备的，如果一定要类比，那它类似于Python中的pyenv+conda；

综上所述，我们要想配置国内镜像源的话，就应该从配置Cargo源以及安装工具链的Rustup源入手，其中，配置Cargo源要在Rust工具链安装完成之后进行，而配置工具链的源应该在最开始进行。

根据官方文档说明，我们可以在使用Rustup下载器下载安装Rust之前，设置好环境变量 CARGO_HOME 和 RUSTUP_HOME 来自定义安装位置，设置RUSTUP_DIST_SERVER和RUSTUP_UPDATE_ROOT来配置国内Rust工具链源。

2.1.配置工具链国内源

目前网上评价比较好的Rust源，一个是中科大的源（USTC文档），一个是字节跳动的源（RsProxy文档）

可以使用管理员权限的powershell命令添加环境变量，也可以手动搜索“环境变量”，打开后选择环境变量进行添加

 

选择新建系统变量，按照字节跳动官方文档进行配置：

# 按照这个参数进行设置
RUSTUP_DIST_SERVER="https://rsproxy.cn"
RUSTUP_UPDATE_ROOT="https://rsproxy.cn/rustup"

 

Rust官方文档对这两个环境变量是这样解释的：

RUSTUP_DIST_SERVER (default: https://static.rust-lang.org). Sets the root URL for downloading static resources related to Rust. You can change this to instead use a local mirror, or to test the binaries from the staging directory.

RUSTUP_UPDATE_ROOT (default https://static.rust-lang.org/rustup). Sets the root URL for downloading self-update.

 

（可选）对于中科大源，本步骤的系统变量则改为：

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

 

配置完成后一路返回点“确定”，即可完成工具链源的配置。

 

2.2.（可选）自定义Rust及工具链安装位置

如果不想更改安装位置的话，RUSTUP_HOME的默认值是~/.rustup 或 %USERPROFILE%/.rustup，也就是装在C盘下的用户目录下，这个不用专门操作，直接跳过这一步，看下一个步骤就行了。

如果要改安装位置，比如我想改到D盘，那就要继续新建环境变量：

CARGO_HOME="D:\Rust\cargo"
RUSTUP_HOME="D:\Rust\rustup"

　　

 

 

三、安装Rust

运行之前在第一步下载好的rustup-init.exe，输入1并回车，开始下载

 

因为我电脑上之前就有Visual Studio等一些工具，所以这里没有弹出下载界面，只在命令行内就完成了下载过程，大概三四分钟的样子：

 ⚠️一天后更新：这里我在ubuntu虚拟机用的是中科大源，正好两个对比一下。一对比发现科大源又稳又快，这样的话，干脆我win11上也换成中科大的源吧：

 

然后回车后自动关闭命令行界面，可以在环境变量-用户变量-Path处看到程序自动添加的CARGO_HOME\bin变量：

 

四、配置Cargo源并验证

4.1.字节源的一个错误配置

在CARGO_HOME下新建config.toml文件（cargo版本 >= 1.68），添加内容如下，这一步用的是字节跳动的源（内容来自字节跳动镜像站官网），这个源设置是有问题的，下面会进行说明，这里展示一下它官网目前所提供的配置内容：

[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

 

如果用中科大的源，应该换成如下内容（内容来自中科大镜像站使用说明）：

[source.crates-io]
replace-with = 'ustc'
​
[source.ustc]
registry = "sparse+https://mirrors.ustc.edu.cn/crates.io-index/"
​
[registries.ustc]
index = "sparse+https://mirrors.ustc.edu.cn/crates.io-index/"

 

当配置Cargo国内源之后，使用cargo search和cargo info命令需要加上 --registry xxxx 参数。如果是中科大源，就加上 --registry ustc ；如果是字节跳动的源，就加上 --registry rsproxy-sparse 。

 

⚠️当配置字节跳动的源运行cargo search serde --registry 'rsproxy-sparse'命令时，会得到报错：

error: registry index was not found in any configuration: `rsproxy-sparse`

　　

意思是Cargo 在其配置中找不到名为 rsproxy-sparse 的注册表 (Registry) 定义。

而中科大源则不会出现这个问题：

那么应该如何更改字节源的配置呢？

 

4.2.正确的字节源配置内容

我们可以仿照中科大源的配置文件，给字节跳动的源加两行：

[registries.rsproxy-sparse]
index = "sparse+https://rsproxy.cn/index/"

也就是说，最终的字节源配置文件内容如下：

[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"

[registries.rsproxy-sparse]
index = "sparse+https://rsproxy.cn/index/"

[net]
git-fetch-with-cli = true

 

修改config.toml文件后，重新运行命令cargo search serde --registry rsproxy-sparse，发现已经成功了：

 

那么字节源也配置完成了。

其实这个配置错误的问题在字节源官网的RsProxy 说明页已经在三个月前被一个网友指出了，但无论是官网页还是详细说明页都没有更改，这一方面让人感觉字节似乎对维护这个镜像不是很用心；但另一方面，字节的这个源速度是很快的，感觉配置也是不低的，应该也是比较上心的才对，这分析起来有点矛盾，也许只是忘改了吧。

可以中科大源结合着字节源一起用，我看中科大的镜像维护文档说明还是很详细的，有什么注意事项都标出来了，不愧是顶尖理工类大学，懂不懂红专并进、理实交融的含金量啊。（要是没有人到处膜就更好了）

⚠️一天后更新：最后还是全部换成了科大源，科大源真好用

 

 

五、使用RustRover建立第一个Rust项目

5.0.标准库准备

之前没有装过Rust，按上述步骤进行后，打开RustRover选择新建项目，可以看到这样的界面：

 

可以看到标准库那是空的，通过查看RustRover官方文档，可以知道IDE这里想要的不是默认安装在电脑上的rust-std-x86_64-pc-windows-msvc组件，而是源代码src，应该是通过rust源码帮助进行代码补全或者查看源码之类的工作的，毕竟CLion就有这样的功能，那就下载一个源码，运行命令rustup component list --installed查看已安装的组件，然后再运行rustup component add rust-src安装rust-src即可。

安装完成后，重启RustRover，可以看到已经自动检测到了标准库源码的位置。

 

 

5.1.自己思考了一点东西

另外，其实上面图中的第一个选项：Toolchain location是不对的，打开命令行，输入rustup show，得到已安装的工具链名称stable-x86_64-pc-windows-msvc：

PS C:\Users\xx> rustup show
Default host: x86_64-pc-windows-msvc
rustup home:  D:\Rust\rustup
​
installed toolchains
--------------------
stable-x86_64-pc-windows-msvc (active, default)
​
active toolchain
----------------
name: stable-x86_64-pc-windows-msvc
active because: it's the default toolchain
installed targets:
  x86_64-pc-windows-msvcain list
stable-x86_64-pc-windows-msvc (active, default)

 

搜索该目录的位置，这个才是工具链的实际位置。

不过无论是查看这里自动扫描到的结果，还是去RustRover官方文档下看教程，你会发现大家用IDE自动扫描到的Toolchain location都是之前设置的CARGO_HOME/bin目录，而不是实际的工具链目录。为什么会这样呢？难道IDE开发者连这么基础的问题都没有意识到吗？应该不是，我问了问AI，它说“RustRover默认扫描 CARGO_HOME/bin，是因为它能从中推断出当前活跃的工具链，并据此找到对应的 toolchains 目录。这是一种可靠且通用的策略。”好吧，很有道理，所以这个Toolchain location我们就不改了。

 

 

5.2.最后一步

万事俱备，点击Create即可。