macOS上用Homebrew装Rust环境需三步:先装Homebrew和Xcode命令行工具,再通过brew install rustup-init安装rustup-init并配置PATH,最后设rsproxy.cn镜像源加速rustup-init及crates.io下载。
在 macos 上用 homebrew 安装 rust 开发环境,核心是分三步走:先装好 homebrew 和系统编译工具,再装 rustup(不是直接 brew install rust),最后配置国内镜像加速。跳过任一环节都可能卡在下载、链接失败或后续更新慢的问题上。
安装 Homebrew 和 Xcode 命令行工具
Homebrew 是 macOS 上最可靠的包管理器,而 Xcode 命令行工具提供 clang、make 等底层编译依赖,Rust 编译器 rustc 必须用到它们。
- 运行 xcode-select --install,弹窗确认安装命令行工具(约 1–2 分钟)
- 用国内镜像源安装 Homebrew(避免 GitHub 域名被限):
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)" - 安装完成后执行 brew doctor 检查环境是否就绪
通过 Homebrew 安装 rustup-init
官方推荐用 rustup 管理 Rust 工具链(含 rustc、cargo、rust-docs 等),Homebrew 提供的是 rustup-init 这个初始化工具,它比直接 brew install rust 更可控、更符合 Rust 社区惯例。
- 执行 brew install rustup-init
- rustup-init 默认安装路径是 /usr/local/opt/rustup/bin,需手动加入 PATH:
echo 'export PATH="/usr/local/opt/rustup/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 验证是否生效:which rustup-init 应返回路径
初始化并配置国内镜像源
Rust 官方服务器在国外,首次安装 rustup-init 时若不设镜像,下载速度常低于 300 KB/s,甚至超时中断。建议一步到位设置字节跳动 rsproxy.cn 镜像(目前最稳定)。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
- 临时生效(仅本次安装):
export RUSTUP_DIST_SERVER="https://rsproxy.cn"
export RUSTUP_UPDATE_ROOT="https://rsproxy.cn"
rustup-init - 永久生效(推荐):
echo 'export RUSTUP_DIST_SERVER="https://rsproxy.cn"' >> ~/.zshrc
echo 'export RUSTUP_UPDATE_ROOT="https://rsproxy.cn"' >> ~/.zshrc
source ~/.zshrc - 安装过程中按回车选默认选项(1),完成后运行 rustc --version 和 cargo --version 验证
可选但强烈建议:配置 crates.io 国内镜像
这步影响后续 cargo build 下载第三方 crate 的速度。不配的话,time、serde 等常用库可能卡住几分钟。
- 创建配置目录:mkdir -p ~/.cargo
- 写入镜像配置:
cat > ~/.cargo/config.toml [source.crates-io]
replace-with = 'rsproxy'
[source.rsproxy]
registry = "https://rsproxy.cn/index/"
EOF - 之后所有 cargo 操作都会自动走 rsproxy.cn,实测下载速度可达 5–10 MB/s










