macOS 上用 Homebrew 配 Rust 环境的关键是正确配置环境变量和国内源：先用 Gitee 镜像装 Homebrew，再装 Xcode 命令行工具，接着 brew install rustup-init 并手动添加 PATH，用 rsproxy.cn 镜像运行 rustup-init，最后配置 ~/.cargo/config.toml 使用清华源。
macos 上用 homebrew 安装并配好 rust 开发环境，关键不在“装没装上”，而在“环境变量对不对”和“国内源有没有设”。直接 brew install rust 很容易卡住或装出不可用的版本，下面几步走稳，10 分钟内就能跑起 cargo new hello && cargo run。
安装 Homebrew（若尚未安装）
国内网络下推荐用 Gitee 镜像脚本，速度快、成功率高：
- 复制粘贴执行这行命令（注意空格和 URL 连续性）：
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)" - 按提示选「1」继续，等待自动完成
- 完成后运行 brew --version 确认可用
装 Xcode 命令行工具（必需依赖）
Rust 编译器 rustc 在 macOS 上必须调用系统 linker（如 ld），这个由 Xcode 命令行工具提供，不是可选项：
- 终端运行：xcode-select --install
- 弹窗点“安装”，等进度条结束即可（无需完整 Xcode IDE）
- 验证：运行 clang --version 或 pkg-config --version 应有输出
通过 Homebrew 安装 rustup-init 并初始化工具链
Homebrew 默认不直接装 rustc，而是装 rustup-init —— 这是官方推荐的工具链管理器，更可控：
- 执行：brew install rustup-init
- rustup-init 是 keg-only（不自动加入 PATH），需手动加路径：
echo 'export PATH="/usr/local/opt/rustup/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc - 运行：rustup-init，按回车选「1」默认安装
- 若卡在下载环节（常见于访问 rust-lang.org CDN 慢），立即 Ctrl + C 中断，再执行以下三行启用字节跳动镜像：
export RUSTUP_DIST_SERVER="https://rsproxy.cn"
export RUSTUP_UPDATE_ROOT="https://rsproxy.cn"
rustup-init
配置 Cargo 国内源（避免后续下载依赖龟速）
rustup 装好了 rustc 和 cargo，但 cargo 默认从 crates.io 下载包，国内直连极慢。必须配置本地镜像：
- 创建目录：mkdir -p ~/.cargo
- 新建配置文件：nano ~/.cargo/config.toml
- 填入以下内容（推荐清华源，稳定且同步及时）：
[source.crates-io]
replace-with = "tuna"
[source.tuna]
registry = "https://mirrors.tuna.tsinghua.edu.cn/crates.io-index" - 保存退出，运行 rustc --version 和 cargo --version 确认输出正常
- 快速验证：cargo new hello && cd hello && cargo run，看到 “Hello, world!” 即成功
