Ubuntu中配置【Rust 镜像源】

本篇主要记录Ubuntu中配置Rust编程环境时，所需要做的镜像源相关的配置

1. 无法下载 Rust 工具链

通过环境变量指定 Rust 的国内镜像源（如中科大或清华源）。

方法一：临时设置镜像

export RUSTUP_DIST_SERVER=https://mirrors.ustc.edu.cn/rust-static
export RUSTUP_UPDATE_ROOT=https://mirrors.ustc.edu.cn/rust-static/rustup
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

方法二：永久设置镜像

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

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

然后运行：

source ~/.bashrc

2. 无法连接到 crates.io（Rust 的包注册中心）

由于 crates.io 服务器在国外，国内访问可能会很慢或超时。可以使用 中科大或清华的镜像源 加速下载：

方法1：临时设置镜像

在终端运行以下命令，临时更换 crates.io 源：

# 使用中科大镜像
export CARGO_REGISTRIES_CRATES_IO_PROTOCOL=sparse
export CARGO_HTTP_MULTIPLEXING=false  # 避免某些网络环境下的问题
export RUSTUP_DIST_SERVER="https://mirrors.ustc.edu.cn/rust-static"
export RUSTUP_UPDATE_ROOT="https://mirrors.ustc.edu.cn/rust-static/rustup"

# 修改 cargo 源
cat <<EOF > ~/.cargo/config
[source.crates-io]
replace-with = 'ustc'

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

然后重新运行：

# 安装 cargo-binutils（用于生成二进制文件）
cargo install cargo-binutils

方法 2：永久修改 ~/.cargo/config

如果想永久使用镜像，可以手动创建或修改 ~/.cargo/config 文件：

mkdir -p ~/.cargo
cat <<EOF > ~/.cargo/config
[source.crates-io]
replace-with = 'ustc'

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

[net]
git-fetch-with-cli = true  # 强制使用 git 命令行（避免某些网络问题）
EOF

然后重新运行下载命令即可。