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 才识别。










