当Mac终端提示“command not found”但程序已安装时，需将程序路径永久添加到~/.zshrc的PATH变量中：先确认Shell为zsh，再用nano/code/open -e编辑~/.zshrc，在末尾添加export PATH="/your/path:$PATH"，执行source ~/.zshrc生效并验证。
当Mac终端提示“command not found”却确认程序已安装时，说明该程序路径未被系统识别，必须将它永久写入~/.zshrc中的PATH变量，否则每次重启终端都要重新设置。
确认当前Shell是zsh
打开终端，执行：
echo $SHELL
输出必须为 /bin/zsh。如果不是，后续所有对~/.zshrc的修改都不会生效——此时应先切换Shell或改用对应配置文件（如~/.bash_profile）。
创建并打开~/.zshrc文件
方法一：用nano编辑器（推荐新手）
执行 nano ~/.zshrc。若文件不存在，nano会自动新建一个空文件，直接进入编辑状态。
方法二：用VS Code打开（需已安装code命令）
执行 code ~/.zshrc。图形界面编辑更直观，支持语法高亮和多行操作。
方法三：用系统文本编辑器
执行 open -e ~/.zshrc。注意：TextEdit保存时务必选择“纯文本”格式，否则会插入不可见格式字符，导致zsh启动时报错退出。
在文件末尾添加PATH配置
第一步：追加路径到PATH变量
在文件最后一行写入 export PATH="/your/program/path:$PATH"，例如 brew 安装的工具路径为 /opt/homebrew/bin，则写：
export PATH="/opt/homebrew/bin:$PATH"
第二步：避免覆盖系统默认路径
绝不能写成 PATH="/your/path" —— 这会清空原有PATH，导致 ls、cd、python 等基础命令全部失效。必须保留 $PATH 在右侧，确保原有路径不丢失。
第三步：验证路径真实存在
在添加前，先执行 ls -d /opt/homebrew/bin。如果报错“No such file or directory”，说明路径错误或软件未正确安装，需修正后再写入配置文件。
让新配置立即生效
执行 source ~/.zshrc。
这一步跳过重启终端，使刚写的PATH定义立刻加载进当前会话。不执行此命令，新路径在当前窗口中完全不可用。
验证是否成功：
输入 echo $PATH，检查输出中是否包含你刚添加的路径；
再直接运行一个该路径下的命令（如 brew 或 node），能正常执行即表示配置完成。
