Rust 這幾年在系統編程、WebAssembly、區塊鏈、后端服務領域越來越火，很多開發者都在嘗試用它做一些新項目。
但是國內安裝 Rust 開發環境時，經常遇到 安裝慢、依賴拉不下來、crates.io 超時 等問題。本文結合個人踩坑經驗，整理了一份 跨平臺（Windows / macOS / Linux）全流程安裝與鏡像配置指南，希望能幫到后來人。

---

一、安裝方式對比

Rust 的官方推薦安裝方式是通過 rustup，它不僅能幫你安裝編譯器 rustc，還可以管理多個版本、安裝 cargo 包管理工具。

常見安裝路徑：

• 官方 rustup-init
  跨平臺支持最好，但國內下載速度比較慢。

• 國內鏡像站
  比如清華、中科大等高校鏡像源，下載速度更快。

• 包管理器
  macOS 用戶可以用 brew，Linux 可以用 apt/yum/dnf，Windows 可以用 scoop/choco，但更新往往不如 rustup 及時。

建議新手直接用 rustup，方便切換版本和管理工具鏈。

---

二、Windows 安裝流程

1. 下載安裝器

   # 官方方式（可能很慢）
   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs -o rustup-init.exe
   .\rustup-init.exe# 推薦使用清華鏡像加速
   set RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup
   set RUSTUP_UPDATE_ROOT=https://mirrors.tuna.tsinghua.edu.cn/rustup/rustup
   

   然后運行 rustup-init.exe，按提示安裝。

2. 配置環境變量
   安裝后，Rust 工具鏈默認會放在：

   C:\Users\<用戶名>\.cargo\bin
   

   確保這個路徑已經加入到 PATH。

3. 驗證安裝

   rustc --version
   cargo --version
   

---

三、macOS 安裝流程

1. 使用 Homebrew 安裝依賴

   brew install rustup-init
   rustup-init
   

2. 配置國內鏡像（推薦在 .zshrc 或 .bashrc 中寫入）：

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

3. 初始化環境

   source $HOME/.cargo/env
   rustc --version
   cargo --version
   

---

四、Linux 安裝流程

Linux 用戶建議直接用 rustup：

1. 下載安裝腳本

   curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
   

2. 配置國內鏡像（推薦寫入 ~/.bashrc 或 ~/.zshrc）：

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

3. 加載環境變量并驗證

   source $HOME/.cargo/env
   rustc --version
   cargo --version
   

---

五、配置 crates.io 國內源

Rust 的依賴管理通過 cargo 完成，默認從 crates.io 下載。但國內訪問經常超時，需要配置鏡像源。

1. 全局配置
   編輯 $HOME/.cargo/config.toml（沒有就新建）：

   [source.crates-io]
   replace-with = 'ustc'[source.ustc]
   registry = "https://mirrors.ustc.edu.cn/crates.io-index"[net]
   git-fetch-with-cli = true  # 避免部分環境下 libgit2 超時
   

   這樣所有項目都會走 USTC 鏡像。

2. 單項目配置
   如果只想在某個項目用鏡像，可以在項目根目錄新建 .cargo/config.toml 文件，寫入相同內容。

---

六、常見問題與避坑指南

1. cargo build 卡死在下載依賴
   → 確認 .cargo/config.toml 已正確配置鏡像，尤其是 [source.crates-io] replace-with。

2. Windows PowerShell 環境變量不生效
   → 需要在系統級環境變量里寫入，重啟 PowerShell。

3. 不同項目需要不同版本 Rust
   → 用 rustup override set stable 或 rustup override set nightly 來指定項目使用的工具鏈。

4. 升級慢或失敗
   → 換成中科大或清華鏡像，更新時加 RUSTUP_DIST_SERVER 環境變量。

---

Rust 的安裝與環境配置本身不復雜，真正的難點在于 國內網絡環境 導致下載緩慢或失敗。
建議：

• 安裝器 用 rustup，方便版本管理；

• 鏡像源 配置清華/中科大鏡像，加速 crates 下載；

• 跨平臺 建議寫好 ~/.cargo/config.toml，不管在哪臺機器都能統一使用。

這樣一套配置下來，基本可以保證在 Windows / macOS / Linux 下都有順暢的開發體驗。