先执行echo $SHELL确认shell类型，再运行which php获取真实PHP路径；Apple Silicon用echo 'export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"' >> ~/.zshrc，Intel Mac用echo 'export PATH="/usr/local/bin:/usr/local/sbin:$PATH"' >> ~/.zshrc，最后source ~/.zshrc生效。
确认当前 shell 类型和 PHP 路径
Mac 终端默认用 zsh，但旧系统或手动改过的人可能还在用 bash。不确认就瞎改配置文件，source 了也没用。先执行：echo $SHELL —— 输出 /bin/zsh 就编辑 ~/.zshrc；输出 /bin/bash 就编辑 ~/.bash_profile。
再跑：which php —— 如果返回空，说明没装或没在 PATH 里；如果返回类似 /opt/homebrew/bin/php（Apple Silicon）或 /usr/local/bin/php（Intel），这个路径就是你要加的。
追加 PATH 时别覆盖、别手输、别漏冒号
常见错误是直接复制粘贴一行 export PATH="..." 到配置文件里，结果把原有 PATH 冲掉了，连 ls 都找不到。正确做法是只追加，不重写：
• Apple Silicon（M1/M2/M3）：echo 'export PATH="/opt/homebrew/bin:/opt/homebrew/sbin:$PATH"' >> ~/.zshrc
• Intel Mac：echo 'export PATH="/usr/local/bin:/usr/local/sbin:$PATH"' >> ~/.zshrc
注意：
• 用 >> 追加，不是 > 覆盖
• $PATH 必须在引号**里面**且带美元符，否则变量不展开
• 冒号 : 是路径分隔符，不能写成中文顿号或空格
• 不要手动输入 export PATH= 后再敲回车——容易打错等号或引号
生效前必须 source，新开终端也不一定自动加载
source ~/.zshrc 是让当前终端立刻读取新配置的唯一方式。只改文件不 source，php -v 还是报错。
但要注意：
• 如果你用的是 VS Code 内置终端，它可能缓存旧环境，关掉再重开终端窗口才生效
• iTerm2 用户如果启用了“启动时运行命令”，得检查是否设置了自定义 shell 或 login shell，否则 ~/.zshrc 可能不加载
• source 报错？大概率是上一步引号没闭合或等号前后有空格，用 cat ~/.zshrc | tail -3 看最后几行就能定位
验证失败时优先查这三处
php -v 还是 command not found？别急着重装，先盯住这三个点：
• echo $PATH 输出里有没有你刚加的路径？没有 → 配置没生效或写错文件
• ls -l /opt/homebrew/bin/php（或你实际路径）是否存在且有执行权限？不存在 → Homebrew 没装好，或装了但路径变了
• type php 和 which php 输出是否一致？不一致说明有 alias 或函数干扰，临时加 \php -v 绕过 alias 测试
Homebrew 安装的 PHP 默认带 php@8.3 这类版本后缀，brew install php 实际链接到最新稳定版，但如果你手动装过多个版本，which php 可能指向旧版本或失效软链 —— 此时要删掉旧软链再 brew link php
立即学习“PHP免费学习笔记（深入）”；
