Rust 安裝指南（Mac）

本指南將幫助您在 macOS 系統(tǒng)上安裝 Rust 編程語言及其相關(guān)工具鏈。

快速安裝

使用 rustup（推薦方式）

運行以下命令來安裝 Rust：

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

命令說明：

• 此命令會下載并運行 rustup 安裝腳本
• rustup 是 Rust 的官方工具鏈管理器
• 安裝過程中可能需要輸入管理員密碼
• 會自動安裝最新的穩(wěn)定版 Rust

安裝成功后，您會看到以下提示信息：

Rust is installed now. Great!

安全提示： 如果您對安全性有顧慮，可以先下載腳本進(jìn)行檢查再運行。

配置環(huán)境變量

安裝腳本會自動將 Rust 添加到系統(tǒng) PATH 中，但需要重新啟動終端才能生效。如果您想立即使用 Rust，請運行：

source $HOME/.cargo/env

永久配置（可選）：

根據(jù)您使用的 shell，在相應(yīng)的配置文件中添加以下內(nèi)容：

• Bash 用戶：編輯 ~/.bash_profile
• Zsh 用戶：編輯 ~/.zshrc

export PATH="$HOME/.cargo/bin:$PATH"

安裝必要的系統(tǒng)依賴

Rust 需要鏈接器（linker）來編譯程序。在 macOS 上，您需要安裝 Xcode 命令行工具：

xcode-select --install

為什么需要這些工具：

• 鏈接器用于將編譯后的代碼組裝成可執(zhí)行文件
• 許多 Rust 包（crates）依賴 C/C++ 代碼
• 一些系統(tǒng)級的開發(fā)工具也會用到

管理 Rust 安裝

更新 Rust

使用 rustup 可以輕松更新到最新版本：

rustup update

您也可以查看可用的版本：

rustup show

管理工具鏈

安裝特定版本的 Rust：

# 安裝 beta 版本
rustup install beta

# 安裝 nightly 版本
rustup install nightly

# 切換默認(rèn)版本
rustup default stable

卸載 Rust

如需完全卸載 Rust 和 rustup：

rustup self uninstall

驗證安裝

檢查 Rust 版本

運行以下命令驗證 Rust 是否正確安裝：

rustc --version

成功安裝后，您應(yīng)該看到類似以下的輸出：

rustc 1.90.0 (1159e78c4 2025-09-14)

檢查 Cargo 版本

Cargo 是 Rust 的包管理器和構(gòu)建工具：

cargo --version

創(chuàng)建第一個項目

讓我們創(chuàng)建一個簡單的 "Hello, World!" 項目來測試安裝：

# 創(chuàng)建新項目
cargo new hello_rust
cd hello_rust

# 運行項目
cargo run

如果看到 "Hello, world!" 輸出，恭喜您！Rust 已經(jīng)成功安裝并可以正常使用了。

故障排除

常見問題

問題：命令未找到

• 確保已經(jīng)重啟終端或運行了 source $HOME/.cargo/env
• 檢查 PATH 環(huán)境變量是否包含 $HOME/.cargo/bin

問題：編譯錯誤

• 確保已安裝 Xcode 命令行工具
• 運行 xcode-select --install 安裝必要的開發(fā)工具

問題：權(quán)限錯誤

• 不要使用 sudo 運行 rustup 命令
• 確保對 $HOME/.cargo 目錄有寫入權(quán)限

獲取幫助

如果遇到問題，可以通過以下渠道尋求幫助：

• Rust 官方論壇：users.^[1]
• Discord 社群：Rust 官方 Discord^[2] 的 #beginners 頻道
• Stack Overflow：使用 rust 標(biāo)簽提問
• GitHub：rust-lang/rust^[3] 項目頁面

下一步

安裝完成后，建議您：

1. 閱讀 Rust 程序設(shè)計語言^[4] 官方教程
2. 探索 Rust by Example^[5] 實例教程
3. 查看 ^[6] 了解可用的 Rust 包
4. 配置您喜歡的編輯器或 IDE 的 Rust 支持

快速參考：

• 安裝：curl --proto '=https' --tlsv1.2 https://sh. -sSf | sh
• 更新：rustup update
• 版本檢查：rustc --version
• 創(chuàng)建項目：cargo new project_name
• 運行項目：cargo run