Rust 安装加速指南

Rust 安装加速指南

1. 下载 Rust 安装器

访问 Rust 官网下载安装器：

• Windows : rustup-init.exe
• macOS/Linux : rustup-init.sh

官方下载地址：www.rust-lang.org/tools/insta...

2. 解决 Rust 安装慢问题

2.1 修改 Rust 安装器和套件下载地址

通过设置环境变量配置国内镜像源，大幅提升下载速度：

Windows (PowerShell)

# 设置 Rust 国内镜像源
$ENV:RUSTUP_DIST_SERVER='https://mirrors.aliyun.com/rustup'
$ENV:RUSTUP_UPDATE_ROOT='https://mirrors.aliyun.com/rustup/rustup'

# 然后运行安装器
.\rustup-init.exe

macOS / Linux (Bash)

# 设置 Rust 国内镜像源
export RUSTUP_DIST_SERVER=https://mirrors.aliyun.com/rustup
export RUSTUP_UPDATE_ROOT=https://mirrors.aliyun.com/rustup/rustup

# 然后运行安装器
./rustup-init.sh

2.2 其他国内镜像源（备选）

中科大镜像源

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

清华大学镜像源

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

3. 永久配置镜像源（可选）

3.1 Windows 永久配置

在系统环境变量中添加：

• 变量名：RUSTUP_DIST_SERVER
• 变量值：https://mirrors.aliyun.com/rustup
• 变量名：RUSTUP_UPDATE_ROOT
• 变量值：https://mirrors.aliyun.com/rustup/rustup

3.2 macOS/Linux 永久配置

将以下内容添加到 ~/.bashrc 或 ~/.zshrc：

# Rust 镜像源配置
export RUSTUP_DIST_SERVER=https://mirrors.aliyun.com/rustup
export RUSTUP_UPDATE_ROOT=https://mirrors.aliyun.com/rustup/rustup

然后执行：

source ~/.bashrc  # 或 source ~/.zshrc

4. 验证安装

安装完成后，验证 Rust 是否正确安装：

rustc --version
cargo --version

5. 配置 Cargo 镜像源

安装完成后，还需要配置 Cargo 的镜像源以加速 crate 下载：

创建或修改 ~/.cargo/config 文件

Windows

文件位置：%USERPROFILE%\.cargo\config

macOS/Linux

文件位置：~/.cargo/config

添加以下内容：

[source.crates-io]
registry = "https://github.com/rust-lang/crates.io-index"
replace-with = 'aliyun' # 指定使用下面哪个源，修改为source.后面的内容即可

#阿里云
[source.aliyun]
registry = "sparse+https://mirrors.aliyun.com/crates.io-index/"

# 中国科学技术大学
[source.ustc]
registry = "https://mirrors.ustc.edu.cn/crates.io-index"

# 上海交通大学
[source.sjtu]
registry = "https://mirrors.sjtug.sjtu.edu.cn/git/crates.io-index/"

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

# rustcc社区
[source.rustcc]
registry = "https://code.aliyun.com/rustcc/crates.io-index.git"

[http]
proxy = "http://127.0.0.1:2080"

6. 一键安装脚本（Linux/macOS）

#!/bin/bash

# 设置镜像源
export RUSTUP_DIST_SERVER=https://mirrors.aliyun.com/rustup
export RUSTUP_UPDATE_ROOT=https://mirrors.aliyun.com/rustup/rustup

# 下载并安装 Rust
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

# 配置 Cargo 镜像源
mkdir -p ~/.cargo
cat > ~/.cargo/config << EOF
[source.crates-io]
replace-with = 'ustc'

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

echo "Rust 安装完成！请重新打开终端或执行：source ~/.cargo/env"

---

注意事项：

1. 安装前请确保网络连接正常
2. 如果使用代理，请确保代理设置正确
3. 安装过程中遇到问题，可以尝试切换不同的镜像源
4. 安装完成后建议重启终端使配置生效