Rust在Mac上command not found的解决步骤：一、用rustup安装工具链并source $HOME/.cargo/env；二、手动将$HOME/.cargo/bin加入~/.zshrc或~/.bash_profile；三、运行rustup default stable初始化工具链；四、可选配置USTC镜像加速；五、用cargo new验证全流程。
如果您在Mac上尝试搭建Rust开发环境，但执行rustc或cargo命令时提示command not found，则可能是rustup安装后环境变量未正确加载或工具链未初始化。以下是解决此问题的步骤：
一、通过rustup安装Rust工具链
rustup是Rust官方提供的工具链管理器，可自动下载并配置rustc编译器、cargo包管理器及文档组件，同时支持多版本切换。它默认安装stable通道，适用于绝大多数开发场景。
1、打开终端，确认已安装Xcode命令行工具：运行xcode-select --install，按提示完成安装。
2、执行安装脚本：curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
3、按回车确认标准安装，脚本将自动下载工具链至$HOME/.cargo/bin
4、安装完成后运行source $HOME/.cargo/env立即加载环境变量
5、验证基础命令：rustup --version应返回版本号，如rustup 1.28.2
二、手动配置Shell环境变量
若执行rustup后仍提示rustc未找到，说明$HOME/.cargo/bin未被加入PATH，需显式写入Shell配置文件。该步骤针对zsh（macOS Catalina及以后默认）或bash环境分别处理。
1、运行echo $SHELL确认当前Shell类型，输出为/bin/zsh或/bin/bash
2、若为zsh，执行echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.zshrc
3、若为bash，执行echo 'export PATH="$HOME/.cargo/bin:$PATH"' >> ~/.bash_profile
4、重载配置：source ~/.zshrc或source ~/.bash_profile
5、验证路径生效：which rustc应返回/Users/xxx/.cargo/bin/rustc
三、初始化默认工具链
rustup安装成功仅表示管理器就位，但稳定版Rust编译器（rustc）和标准库尚未下载。必须显式安装工具链，否则cargo run等命令会报“no default toolchain configured”错误。
1、运行rustup default stable设置稳定通道为默认工具链
2、等待自动下载rustc、cargo、rust-std等组件（国内用户可提前配置镜像加速）
3、执行rustc --version与cargo --version，均应显示类似rustc 1.91.0的输出
四、配置国内镜像源（可选但推荐）
因Crates.io官方源在国内访问缓慢，配置USTC镜像可显著提升crate下载与索引更新速度，避免cargo build卡在“Updating crates.io index”阶段。
1、创建配置目录：mkdir -p $HOME/.cargo
2、编辑配置文件：nano $HOME/.cargo/config
3、写入以下内容：
[source.crates-io]
replace-with = 'ustc'
[source.ustc]
registry = "https://mirrors.ustc.edu.cn/crates.io-index"
4、保存退出后，后续所有cargo update和cargo build操作将自动使用USTC镜像
五、验证安装并创建首个项目
Cargo不仅用于构建，还提供项目初始化、依赖解析与运行一体化能力。新建hello_rust项目可端到端验证整个工具链是否正常工作，包括编译器、链接器、标准库及执行环境。
1、执行cargo new hello_rust生成项目骨架
2、进入目录：cd hello_rust
3、运行cargo run，Cargo将自动编译并执行
4、终端输出Hello, world!即表示全部组件协同正常
5、检查src/main.rs内容，确认其为标准Rust入口函数结构
