Rust开发环境安装与crates.io国内源配置（全平台保姆级教程）

为什么需要国内源？

Rust的包管理器cargo默认从crates.io下载依赖包，但服务器在国外，访问不稳定且速度慢。通过配置crates.io国内镜像（如中科大USTC、清华TUNA等），可以大幅提升依赖下载速度。同时，rustup安装工具链时也可以使用镜像加速。本教程将统一配置，一次搞定。

一、Windows安装Rust与配置国内源

Windows Rust环境配置步骤如下：

1. 访问Rust官方安装页面 https://rustup.rs/ ，下载rustup‑init.exe（32位或64位）。
2. 运行安装程序，在命令行中选择默认安装选项（输入1）。安装程序会自动添加Rust和cargo到系统PATH。
3. 打开新的命令提示符或PowerShell，运行 rustc --version 和 cargo --version 验证安装成功。
4. 配置国内源：在用户目录（%USERPROFILE%）下创建文件夹 .cargo，然后在其中新建文件 config（无扩展名）。用记事本编辑，填入以下内容（使用中科大镜像）：

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

如果你希望使用清华源，可以将第二段改为 registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"。保存文件后，cargo就会通过国内镜像下载依赖。

二、macOS安装Rust与国内源配置

对于macOS Rust安装，同样推荐使用rustup方式：

1. 打开终端，执行以下命令安装rustup：curl --proto "=https" --tlsv1.2 -sSf https://sh.rustup.rs | sh
2. 按照提示选择默认安装（输入1）。安装脚本会自动将cargo和rustc加入PATH（需要重启终端或执行 source ~/.cargo/env）。
3. 验证安装：rustc --version
4. 配置国内镜像：编辑或创建 ~/.cargo/config 文件，可以使用vim或nano：nano ~/.cargo/config，然后粘贴与Windows相同的配置内容（中科大或清华源）。

此外，macOS用户还可以通过Homebrew安装Rust：brew install rust，但此方式不会安装rustup，配置源的方式相同。

三、Linux安装Rust与国内源配置

Linux（如Ubuntu、CentOS）的Rust安装教程与macOS类似，同样使用rustup：

1. 在终端运行安装命令（与macOS相同）：curl --proto "=https" --tlsv1.2 -sSf https://sh.rustup.rs | sh
2. 选择默认安装，安装完成后执行 source ~/.cargo/env 或重启终端。
3. 验证：rustc --version
4. 同样创建/编辑 ~/.cargo/config 文件，添加镜像配置。可以使用以下命令快速写入（以中科大专有源为例）：

   mkdir -p ~/.cargocat > ~/.cargo/config <

部分Linux发行版也可以通过系统包管理器安装Rust（如sudo apt install rustc cargo），但版本可能较旧，建议使用rustup。

四、加速rustup安装（可选）

如果你在执行rustup安装脚本时速度缓慢，可以提前设置环境变量使用国内镜像。例如：

• 中科大：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

Windows用户可以在PowerShell中设置临时环境变量：$env:RUSTUP_DIST_SERVER="https://mirrors.ustc.edu.cn/rust-static" 然后再运行rustup-init.exe。

五、验证配置

完成上述步骤后，可以创建一个新Rust项目来测试源是否生效：

    cargo new hello_rustcd hello_rustcargo build  

如果构建过程中依赖下载速度很快，说明crates.io国内镜像配置成功。至此，你已经在Windows/macOS/Linux上完成了Rust开发环境的安装与加速配置，可以愉快地开始Rust编程之旅了！

本文关键词：Rust安装教程、crates.io国内镜像、Windows Rust环境配置、macOS Rust安装。如果你在配置过程中遇到任何问题，欢迎在评论区留言交流。