Rustup 是 macOS 安装管理 Rust 工具链的唯一推荐方式，通过 curl 下载执行 rustup-init 脚本自动安装稳定版、配置路径并设默认工具链；支持切换 nightly/指定版本、镜像加速、Xcode 工具链修复及 rust-toolchain.toml 项目级配置。
Rustup 是 macOS 上安装和管理 Rust 工具链的唯一推荐方式，直接用 curl 安装即可，无需 Homebrew 或手动编译。
怎么用 rustup-init 安装最新稳定版 Rust
macOS（Intel 或 Apple Silicon）都统一走官方脚本安装流程，本质是下载并运行 rustup-init。它会自动检测架构、设置默认工具链（stable）、配置 CARGO_HOME 和 RUSTUP_HOME（默认在 $HOME/.cargo 和 $HOME/.rustup）。
- 打开终端，执行：
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
- 安装过程中按回车接受默认选项（不建议选“1”自定义，除非你明确要禁用
rustc/cargo的 shell 补全或修改路径） - 安装完需重新加载 shell 配置：
source $HOME/.cargo/env
（Zsh 用户确认~/.zshrc是否已自动追加该行；未追加就手动加进去） - 验证：
rustc --version
和cargo --version
应输出版本号
如何切换或安装其他工具链（如 nightly、1.75）
rustup 默认只装 stable，但你可以随时按需拉取 nightly、beta 或指定版本。这些工具链彼此隔离，不会互相污染。
- 安装 nightly：
rustup install nightly
- 安装特定版本（如 1.75.0）：
rustup install 1.75.0
- 查看已安装工具链：
rustup toolchain list
- 临时使用某工具链（当前 shell 有效）：
rustup run nightly rustc --version
- 为某个项目目录设置默认工具链（写入
rust-toolchain.toml）：echo '[toolchain]\nchannel = "nightly"' > rust-toolchain.toml
更新、卸载与常见卡点处理
rustup 自身和所有工具链都通过 rustup update 统一升级，但某些失败场景需要手动干预。
- 常规更新（含 rustup 二进制 + 所有已安装工具链）：
rustup update
- 仅更新 rustup 自身：
rustup self update
- 卸载全部（谨慎！会删掉
$HOME/.cargo和$HOME/.rustup）：rustup self uninstall
- 如果
rustup update卡在 “downloading component” 或报failed to download：大概率是网络问题，可设镜像源（国内用户常用清华源）：export RUSTUP_DIST_SERVER=https://mirrors.tuna.tsinghua.edu.cn/rustup
，再运行 update；注意该变量需写入 shell 配置文件才持久生效 - Apple Silicon Mac 上遇到
error: linker `cc` not found：不是 rustup 问题，是没装 Xcode 命令行工具，运行xcode-select --install
解决
真正容易被忽略的是：rustup 不会自动把新安装的工具链设为默认，rustup install 1.75.0 后仍用 stable，得手动 rustup default 1.75.0；另外，rust-toolchain.toml 的优先级高于全局 default，但只对 cargo 命令生效，IDE（如 VS Code）可能需要重启或重载 Rust Analyzer 才识别。
