终端报 command not found 的根本原因是 shell 配置文件错误覆盖 PATH，导致 /usr/bin、/bin 等核心路径丢失；应检查 ~/.zshrc、~/.zprofile 等文件中 PATH 赋值是否为空或依赖未定义 $PATH，并优先在 .zprofile 中显式设置完整 PATH。
每次打开终端都报 command not found，说明系统找不到基础命令（如 ls、cd、echo），根本原因是 shell 启动时加载的环境变量配置文件破坏了默认 PATH，导致 /usr/bin、/bin 等核心路径被覆盖或清空。
确认问题是否由 shell 配置文件引发
先临时重置 PATH，验证是否是配置文件的问题：在当前终端中执行 export PATH="/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin"。如果此时 ls、cd 等命令立刻恢复正常，就基本锁定是 ~/.zshrc、~/.zprofile 或 ~/.zshenv 中某处写错了 PATH 赋值逻辑。
注意：不要用 $PATH 拼接方式追加路径，比如 export PATH="$PATH:/new/path" —— 如果原始 $PATH 已为空或损坏，这样只会让新路径也失效。
定位出问题的配置文件
macOS 使用 zsh 作为默认 shell，启动时按顺序读取以下文件（仅加载第一个存在的）：/etc/zshenv → ~/.zshenv → /etc/zprofile → ~/.zprofile → /etc/zshrc → ~/.zshrc → /etc/zlogin → ~/.zlogin。
逐个检查这些文件是否存在且内容异常：
运行 ls -la ~/.zshrc ~/.zprofile ~/.zshenv，看哪些文件实际存在；对每个存在的文件，用 cat 文件名 | grep -i "export.*PATH" 查找 PATH 相关行；重点排查是否出现 PATH=""、PATH=空字符串、PATH=$PATH:xxx 但 $PATH 未定义等致命写法。
快速恢复基础命令可用性
方法一：直接重置用户级配置文件
在当前终端中依次执行：
cd ~ → rm -f .zshrc .zprofile .zshenv → touch .zshrc → echo 'export PATH="/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin"' >> .zshrc → source .zshrc
这一步会清空所有自定义配置，只保留最安全的 PATH 基础值。重启终端后，ls、python3、brew 等命令应全部可用。
方法二：若你记得最近修改过哪个文件，可单独修复
比如发现 ~/.zshrc 最后一行是 export PATH="$HOME/mytool/bin:$PATH"，而 $PATH 此时为空——应改为 export PATH="/usr/bin:/bin:/usr/sbin:/sbin:/usr/local/bin:$HOME/mytool/bin"，【必须显式列出所有必要路径，不能依赖未初始化的 $PATH】。
验证并锁定最终生效的配置位置
第一步：查看当前 shell 实际加载了哪个文件
在终端中运行 echo $ZDOTDIR，如果输出为空，则配置文件在用户主目录；如果非空，去该目录下找对应文件。
第二步：确认当前终端启动模式
运行 shopt login_shell（zsh 下实际用 echo $SHLVL 更可靠）。新开终端时 SHLVL=1，说明是登录 shell，会加载 .zprofile；非登录 shell（如 iTerm 新建 tab）只加载 .zshrc。因此 PATH 应优先写在 .zprofile 中，避免 .zshrc 里重复覆盖。
第三步：检查 /etc/paths 是否被篡改
运行 cat /etc/paths，正常应包含 /usr/bin、/bin、/usr/sbin、/sbin、/usr/local/bin（Apple Silicon 机器还应有 /opt/homebrew/bin）。如果缺失关键路径，用 sudo 编辑它：sudo nano /etc/paths，逐行补全后保存。此操作需管理员密码，且无需重启，新终端立即生效。
