Rustup 安装加速：使用国内镜像源解决下载慢问题_rust安装慢

技术文档

Rustup 安装加速：使用国内镜像源解决下载慢问题

当你在国内使用 rustup default stable 命令时，由于默认从国外服务器下载，速度可能会非常慢甚至失败。以下是几种有效的加速方法：

1. 配置国内镜像源环境变量

方法一：临时设置（当前终端会话有效）

export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustupexport RUSTUP_UPDATE_ROOT=https://mirrors.tuna.tsinghua.edu.cn/rustuprustup 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 工具链的下载和安装速度。如果仍然遇到问题，可以尝试更换不同的镜像源或检查网络连接。

Rustup 安装加速：使用国内镜像源解决下载慢问题_rust安装慢