必须用rustup安装,禁用brew install rust;先装Xcode命令行工具,再运行rustup脚本,source环境变量,设default stable工具链,最后验证rustc/cargo版本并运行hello_rust项目。

在Mac上安装Rust开发工具链,必须通过官方推荐的rustup管理器完成,不能用brew install rust替代——后者装的是静态打包版,缺失rust-analyzer所需元数据、不支持nightly通道、无法更新组件,后续所有开发功能都会受限。
安装前准备:确保Xcode命令行工具就位
运行xcode-select --install,弹出图形窗口后点击“安装”,等待进度条走完。这一步不可跳过,因为Rust编译器依赖系统链接器(linker)和C标准库头文件,没有它,后续任何rustc或cargo命令都会报错“ld: library not found for -lc”。
安装完成后执行xcode-select -p,应返回类似/Library/Developer/CommandLineTools的路径,确认生效。
下载并运行rustup安装脚本
打开终端,粘贴执行以下命令:
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
按回车选择默认安装(选项1),脚本将自动下载rustc、cargo、rust-docs等组件到$HOME/.cargo/bin目录。安装过程约1–3分钟,期间可能提示输入管理员密码(这是正常的安全校验)。
安装成功后终端会显示Rust is installed now. Great!,但此时rustc和cargo仍不可用——因为环境变量尚未加载。
立即加载环境变量并验证基础命令
运行:source $HOME/.cargo/env
这一步让当前终端会话立刻识别到rustup命令。验证是否成功:rustup --version应输出类似rustup 1.28.2的版本号。
【注意】此命令仅对当前终端有效,关闭窗口后失效,后续需永久配置PATH。
永久配置Shell环境变量
第一步:确认当前Shell类型:echo $SHELL。macOS Catalina(10.15)及以后系统默认为zsh,输出/bin/zsh;旧系统可能为bash,输出/bin/bash。
第二步:根据结果执行对应命令:
方法一(zsh用户):echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
方法二(bash用户):echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bash_profile && source ~/.bash_profile
第三步:验证PATH已写入:which rustc应返回/Users/你的用户名/.cargo/bin/rustc。若无输出,说明写入失败,需检查配置文件路径是否拼写错误。
初始化默认工具链
rustup安装成功 ≠ Rust编译器就绪。rustup只是个“应用商店”,必须手动下载并启用stable工具链:
运行:rustup default stable
该命令会触发自动下载rustc、cargo、rust-std等核心组件(国内用户此时可提前配置USTC镜像加速,避免卡在“Updating crates.io index”)。下载完成后,执行:
rustc --version 和 cargo --version
两个命令均应正常返回版本号(如rustc 1.91.0),表示工具链初始化完成。
创建并运行第一个Rust项目
执行:cargo new hello_rust → cd hello_rust → cargo run
终端将输出Compiling hello_rust v0.1.0,稍等数秒后打印Hello, world!。这一步验证了cargo能调用rustc完成完整构建→链接→执行闭环,整个工具链已可投入实际开发。











