2 min read

解决 Rust 国内安装慢的问题:详细配置指南

问题背景

在国内环境下安装 Rust 时,由于网络限制和服务器距离较远,常常会遇到下载速度缓慢、连接超时等问题。本文将提供一套完整的解决方案,通过配置国内镜像源来显著提升 Rust 的安装和使用体验。

解决方案概述

我们将通过三个步骤来解决 Rust 国内安装慢的问题:

  1. 设置 Rustup 镜像源
  2. 使用国内镜像安装 Rust
  3. 配置 crates.io 镜像源

步骤一:设置 Rustup 镜像

首先需要配置 Rustup 的镜像源,修改您的 shell 配置文件(根据您使用的 shell 类型):

对于 zsh 用户(修改 ~/.zshrc):

export RUSTUP_DIST_SERVER="https://rsproxy.cn"
export RUSTUP_UPDATE_ROOT="https://rsproxy.cn/rustup"

对于 bash 用户(修改 ~/.bashrc):

export RUSTUP_DIST_SERVER="https://rsproxy.cn"
export RUSTUP_UPDATE_ROOT="https://rsproxy.cn/rustup"

重要提示:修改完成后,需要执行 source ~/.zshrcsource ~/.bashrc 使环境变量生效,或者重新启动终端。

步骤二:安装 Rust

完成步骤一的环境变量配置后,使用国内镜像安装 Rust:

curl --proto '=https' --tlsv1.2 -sSf https://rsproxy.cn/rustup-init.sh | sh

这个命令会下载并运行 Rust 安装脚本,由于我们已经配置了国内镜像源,下载速度将会得到显著提升。

步骤三:设置 crates.io 镜像

安装完成后,还需要配置 Cargo 的包源镜像。修改配置文件 ~/.cargo/config(如果文件不存在则需要创建):

[source.crates-io]
replace-with = 'rsproxy-sparse'

[source.rsproxy]
registry = "https://rsproxy.cn/crates.io-index"

[source.rsproxy-sparse]
registry = "sparse+https://rsproxy.cn/index/"

[registries.rsproxy]
index = "https://rsproxy.cn/crates.io-index"

[net]
git-fetch-with-cli = true

配置说明:

  • sparse 协议支持:此配置已支持 git 协议和 sparse 协议
  • 版本建议:对于 Rust 1.68 及以上版本,建议使用 sparse-index,速度更快
  • 镜像选择:我们使用了 rsproxy 作为主要镜像源,它是国内稳定的 Rust 镜像服务

验证配置

完成所有配置后,可以通过以下命令验证安装是否成功:

rustc --version
cargo --version

然后尝试创建一个新项目来测试包下载速度:

cargo new test_project
cd test_project
cargo build

总结

通过以上三个步骤的配置,您应该能够显著改善在国内环境下使用 Rust 的体验。主要优势包括:

  • Rust 安装速度大幅提升
  • Cargo 依赖包下载更加迅速
  • 减少网络连接超时问题
  • 整体开发效率得到改善

如果在配置过程中遇到问题,建议检查环境变量是否正确设置,以及配置文件路径和语法是否正确。祝您使用愉快!