Rust 在 macOS 上安装失败需依次检查环境变量、Shell 类型、工具链、镜像源及 Xcode 工具：一、用 rustup 安装工具链；二、Zsh 用户需手动在 ~/.zshrc 中添加 PATH；三、运行 rustup install stable 并设为默认；四、配置中科大镜像加速 crates.io；五、安装 Xcode 命令行工具提供链接器。
如果您在 macOS 系统上尝试安装 Rust 语言，但执行安装命令后未生效或命令不可识别，则可能是由于环境变量未正确配置、Shell 类型不匹配或网络连接异常所致。以下是解决此问题的步骤：
一、使用 rustup 安装 Rust 工具链
rustup 是 Rust 官方推荐的工具链管理器，可自动下载并安装稳定版编译器（rustc）、包管理器（cargo）及文档工具（rustdoc）。该方式支持后续版本升级与多工具链切换。
1、打开终端（Terminal），粘贴并执行以下命令：
2、按提示输入密码（若需管理员权限）；
3、安装过程中出现交互界面时，直接按回车选择默认安装（选项 1）；
4、等待脚本完成下载与安装，成功后将显示 Rust is installed now. Great!。
二、手动配置环境变量（Zsh 用户）
macOS 自 macOS Catalina 起默认使用 Zsh，而 rustup 安装脚本可能仅修改了 ~/.bash_profile，导致 Zsh 终端无法识别 rustc 或 cargo 命令。
1、确认当前 Shell 类型：运行 echo $SHELL，输出应为 /bin/zsh；
2、编辑 Zsh 配置文件：nano ~/.zshrc；
3、在文件末尾新增一行：export PATH="$HOME/.cargo/bin:$PATH"；
4、保存并退出（Ctrl+O → Enter → Ctrl+X）；
5、立即加载配置：source ~/.zshrc。
三、验证安装并补装工具链
rustup 安装成功后，仅部署了工具链管理器本身，Rust 编译器（stable 工具链）需单独下载。若运行 rustc 报错提示“no default toolchain”，说明此步骤尚未执行。
1、运行 rustup show，检查是否列出已安装的工具链；
2、若未显示 stable 工具链，执行：rustup install stable；
3、设置为默认：rustup default stable；
4、验证编译器与包管理器：rustc --version 和 cargo --version。
四、配置国内镜像源（加速依赖下载）
因 crates.io 官方索引服务器位于境外，国内用户首次运行 cargo new 或 cargo build 时易出现超时或卡顿。通过替换索引源可显著提升下载速度与稳定性。
1、创建配置目录：mkdir -p ~/.cargo；
2、新建或编辑配置文件：nano ~/.cargo/config；
3、写入以下内容（使用中科大镜像）：
4、保存退出后，后续 cargo 操作将自动从 https://mirrors.ustc.edu.cn/crates.io-index 获取元数据。
五、安装 Xcode 命令行工具（必需链接器支持）
Rust 编译生成可执行文件需系统链接器（linker）。macOS 不预装完整开发工具集，缺少链接器将导致编译失败，错误信息通常包含 linker not found 或 ld: command not found。
1、运行 xcode-select --install；
2、在弹出窗口中点击“安装”，等待完成；
3、验证安装：clang --version 应返回版本信息；
4、如已安装 Xcode 全量版，仍需运行 sudo xcode-select --switch /Applications/Xcode.app 指定路径。
