根本原因是PATH环境变量未包含程序路径，需按Shell类型写入~/.zshrc（zsh）或~/.bash_profile（bash）实现用户级生效，或通过/etc/paths.d/添加路径实现GUI应用全局生效。
Mac终端输入命令提示“command not found”，根本原因是系统找不到可执行文件的位置，必须把程序所在目录正确添加进PATH环境变量，且确保该配置对所有新打开的终端窗口、GUI应用（如VS Code、IntelliJ）都生效。
确认当前Shell类型
打开终端，依次执行两行命令：
echo $SHELL → 查看登录时设定的默认shell路径；
echo $0 → 查看当前实际运行的shell进程名。
如果两者都显示 /bin/zsh，说明你用的是zsh（macOS Catalina及之后默认）；若显示 /bin/bash 或 /usr/local/bin/bash，则属于bash体系。注意：【$SHELL可能滞后于实际shell，务必以$0为准】。
用户级持久化配置（推荐新手首选）
适用于仅影响当前用户、不改动系统文件、重启终端即自动加载的场景。
方法一：zsh用户写入~/.zshrc
第一步：在终端中运行 touch ~/.zshrc && open -e ~/.zshrc，用TextEdit打开该文件（若文件不存在会自动创建）；
第二步：在文件末尾新增一行，格式为 export PATH="/your/program/path:$PATH"，例如你要加Homebrew的路径，就写 export PATH="/opt/homebrew/bin:$PATH"；
第三步：保存文件，回到终端执行 source ~/.zshrc 立即生效；
第四步：运行 echo $PATH，确认新路径出现在输出最前面——因为PATH从左到右搜索，靠前的路径优先匹配。
方法二：bash用户写入~/.bash_profile
直接执行 open -e ~/.bash_profile，在文件末尾添加同格式的export语句，保存后运行 source ~/.bash_profile 即可。
系统级全局配置（所有用户+GUI应用生效）
当你需要让VS Code、PyCharm等图形界面程序也能识别新命令时，用户级配置往往失效——GUI应用不读~/.zshrc，而依赖/etc/paths.d/机制。
① 执行 sudo mkdir -p /etc/paths.d 确保目录存在；
② 运行 sudo nano /etc/paths.d/mytools（文件名可任意，如mytools、java、go）；
③ 在nano编辑器中，**只写一行绝对路径**，例如 /usr/local/go/bin 或 /opt/homebrew/bin，【严禁写export、$PATH、冒号分隔多个路径】；
④ 按 Ctrl+O 回车保存，Ctrl+X 退出；
⑤ 关闭当前所有终端窗口，重新打开一个——此时 echo $PATH 应包含你刚添加的路径，且在VS Code集成终端里也能直接运行对应命令。
临时验证与快速测试
在终端里直接运行：export PATH="/tmp/testbin:$PATH"；
立刻执行 echo $PATH 查看是否插入成功；
再尝试运行一个该目录下的可执行文件（如 ls /tmp/testbin 后跟文件名）；
关闭终端后该设置自动消失，不影响任何配置文件。
