“command not found”本质是shell按PATH查找可执行文件失败，主因是PATH配置错误；需依次验证当前PATH、检查shell配置文件中PATH赋值是否清空或拼写错误、确认Xcode命令行工具就位，并确保配置文件被正确加载。
终端输入命令提示“command not found”，本质是 shell 找不到该命令对应的可执行文件，最常见、最直接的原因就是 path 环境变量配置错误。排查要从当前会话状态入手，再逐层定位配置源头，最后验证修复效果。
第一步：确认当前 PATH 是否异常
先看问题是否真实存在——不是命令没装，而是路径断了：
- 运行
echo $PATH，观察输出。正常 macOS 的 PATH 应包含/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin等核心路径；如果输出为空、极短、含明显错字（如/user/local/bin）、或只有单个自定义路径，基本可判定 PATH 被覆盖或写错 - 尝试用绝对路径运行基础命令，比如
/bin/ls或/usr/bin/curl --version。若能成功，说明命令本身完好，只是 PATH 没指向它们 - 检查当前 shell 类型：
echo $SHELL。Catalina（10.15）及以后默认为/bin/zsh，旧系统可能是/bin/bash；这决定了你要查哪个配置文件
第二步：检查 shell 配置文件中的 PATH 赋值
临时修复后，必须回溯到配置源头，否则新开终端还会失效：
- 根据
$SHELL结果，打开对应文件：~/.zshrc（zsh）、~/.bash_profile（bash），或~/.zprofile（zsh 登录时优先读取） - 搜索
export PATH=或PATH=。重点识别两类错误：
— 使用=直接赋值（如export PATH="/my/path"），会清空原有 PATH
— 路径拼写错误（如把/usr写成/user）或引用了已卸载软件的旧路径（如 Homebrew 迁移后仍留着/usr/local/bin但 Apple Silicon 实际在/opt/homebrew/bin） - 正确写法应为追加形式：
export PATH="/opt/homebrew/bin:$PATH"（M1/M2/M3）或export PATH="/usr/local/bin:$PATH"（Intel），确保原有路径不丢失
第三步：验证 Xcode 命令行工具是否就位
很多开发命令（git、make、curl）依赖 Xcode 命令行工具，系统更新常导致其路径失效：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 运行
xcode-select -p，正常应返回/Library/Developer/CommandLineTools；若报错invalid active developer path，说明工具链丢失 - 执行
xcode-select --install触发系统弹窗安装（无需下载完整 Xcode） - 若已安装但路径错乱，用
sudo xcode-select --reset恢复默认；也可手动指定：sudo xcode-select -s /Library/Developer/CommandLineTools
第四步：确认配置文件是否被实际加载
写了 PATH 不等于生效，shell 必须读取并执行它：
- 修改配置文件后，必须运行
source ~/.zshrc（或对应文件）让改动立即生效 - 新开终端窗口，再次
echo $PATH和which git验证；如果仍不对，检查是否有多个配置文件互相覆盖（例如.zshrc中又source ~/.bash_profile，而后者里有错误 PATH） - Zsh 启动时按顺序读取
~/.zprofile → ~/.zshrc，PATH 设置建议统一放在~/.zshrc（交互式 shell）或~/.zprofile（登录 shell），避免分散
