Rustup 安装加速:使用国内镜像源解决下载慢问题
当你在国内使用 rustup default stable
命令时,由于默认从国外服务器下载,速度可能会非常慢甚至失败。以下是几种有效的加速方法:
1. 配置国内镜像源环境变量
方法一:临时设置(当前终端会话有效)
export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup
export RUSTUP_UPDATE_ROOT=https://mirrors.tuna.tsinghua.edu.cn/rustup
rustup default stable
方法二:永久设置(推荐)
- Linux/Mac :将上述环境变量添加到
~/.bashrc
或~/.zshrc
文件末尾,然后执行source ~/.bashrc
- Windows:通过系统属性 > 高级 > 环境变量添加这两个变量
2. 常用国内镜像源地址
镜像源提供方 | RUSTUP_DIST_SERVER | RUSTUP_UPDATE_ROOT |
---|---|---|
清华大学 TUNA | https://mirrors.tuna.tsinghua.edu.cn/rustup |
https://mirrors.tuna.tsinghua.edu.cn/rustup |
中科大 USTC | https://mirrors.ustc.edu.cn/rust-static |
https://mirrors.ustc.edu.cn/rust-static/rustup |
阿里云 | https://mirrors.aliyun.com/rustup |
https://mirrors.aliyun.com/rustup/rustup |
字节跳动 | https://rsproxy.cn |
https://rsproxy.cn/rustup |
上海交大 | https://mirrors.sjtug.sjtu.edu.cn/rust-static/ |
- |
3. 同时配置 Cargo 镜像源加速依赖下载
在 ~/.cargo/config
(Windows 为 %USERPROFILE%\.cargo\config
)中添加:
[source.crates-io]
replace-with = 'ustc' # 可替换为 tuna/aliyun 等
# 清华大学镜像源
[source.tuna]
registry = "https://mirrors.tuna.tsinghua.edu.cn/git/crates.io-index.git"
# 中科大镜像源
[source.ustc]
registry = "https://mirrors.ustc.edu.cn/crates.io-index"
# 阿里云镜像源(需要 cargo >=1.68)
[source.aliyun]
registry = "sparse+https://mirrors.aliyun.com/crates.io-index/"
4. 其他优化建议
-
安装前清理缓存(如果之前安装失败):
rustup self clean
-
使用最新版 rustup:
rustup self update
-
对于 Windows 用户:确保已安装 Visual C++ 构建工具,否则 rustup 会先尝试下载这些依赖
-
网络不稳定时:可以尝试多次执行命令,或使用网络代理工具
5. 验证安装
配置完成后,运行:
rustup default stable
然后验证版本:
rustc --version
通过以上方法,你应该能够显著提高 Rust 工具链的下载和安装速度。如果仍然遇到问题,可以尝试更换不同的镜像源或检查网络连接。