Rust配置国内源后快速升级教程

星如雨落2025-07-20 10:35

在中国大陆使用 Rust 时，可以通过配置国内镜像源来加速下载和更新。

编辑或创建 ~/.cargo/config 文件（Windows 在 %USERPROFILE%\.cargo\config），添加以下内容： 中国科学技术大学 (USTC)源:

toml 复制代码

[source.crates-io]
replace-with = 'ustc'

[source.ustc]
registry = "git://mirrors.ustc.edu.cn/crates.io-index"

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

或者使用清华大学源：

toml 复制代码

[source.crates-io]
replace-with = 'tuna'

[source.tuna]
registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"

1). Linux/macOS系统（永久生效）： 将环境变量写入 shell 配置文件（如 ~/.bashrc 或 ~/.zshrc 或 ~/.profile）永久生效，设置环境变量来加速 rustup 工具链下载。

中国科学技术大学 (USTC)源:

bash 复制代码

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

或者使用清华大学源：

bash 复制代码

export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup

最后执行source ~/.bashrc 或 source ~/.zshrc 或 source ~/.profile使变量生效。

2).Windows 系统（永久生效）：

右键 "此电脑" → 属性 → 高级系统设置 → 环境变量
在 "用户变量" 或 "系统变量" 中新建：
- 变量名：RUSTUP_DIST_SERVER
- 变量值：https://mirrors.ustc.edu.cn/rust-static
- 变量名：RUSTUP_UPDATE_ROOT
- 变量值：https://mirrors.ustc.edu.cn/rust-static/rustup

配置完成后，可以运行以下命令验证：

bash 复制代码

rustc --version
cargo --version

如果版本号显示正常，说明配置成功。

配置好国内源后，快速升级 Rust ，可以使用以下命令：

bash 复制代码

rustup self update && rustup update

这会自动检查并安装最新稳定版本的 Rust。如果下载速度明显提升，说明配置成功。