一、配置国内镜像源
在中国大陆使用 Rust 时,可以通过配置国内镜像源来加速下载和更新。
1. Rustup 镜像配置
编辑或创建 ~/.cargo/config
文件(Windows 在 %USERPROFILE%\.cargo\config
),添加以下内容:
中国科学技术大学 (USTC)源:
1 2 3 4 5 6 7 8 9 |
[source.crates-io] replace-with = 'ustc' [source.ustc] registry = "git://mirrors.ustc.edu.cn/crates.io-index" [net] git-fetch-with-cli = true |
或者使用清华大学源:
1 2 3 4 5 6 |
[source.crates-io] replace-with = 'tuna' [source.tuna] registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git" |
2. Rustup 工具链镜像
1). Linux/macOS系统(永久生效):
将环境变量写入 shell 配置文件(如 ~/.bashrc
或 ~/.zshrc
或 ~/.profile
)永久生效,设置环境变量来加速 rustup 工具链下载。
中国科学技术大学 (USTC)源:
1 2 3 |
export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup |
或者使用清华大学源:
1 2 |
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
二、验证配置
配置完成后,可以运行以下命令验证:
1 2 3 |
rustc --version cargo --version |
如果版本号显示正常,说明配置成功。
三、快速升级 Rust
配置好国内源后,快速升级 Rust ,可以使用以下命令:
1 2 |
rustup self update && rustup update |
这会自动检查并安装最新稳定版本的 Rust。如果下载速度明显提升,说明配置成功。