PhpStorm 找不到 php 命令是因为 GUI 启动不读取 shell 的 PATH；需手动配置绝对路径（macOS/Linux 用 which php，Windows 用 where php），通过 Settings → PHP → Interpreter 指定 php.exe（非 php-cgi.exe），并确保用终端启动（macOS：open -a PhpStorm）以继承环境变量。
PhpStorm 找不到 php 命令，不是它坏了，而是它压根没读你的 PATH 环境变量。 macOS 从 Dock 启动、Windows 双击快捷方式时，GUI 进程完全跳过 shell 配置（如 ~/.zshrc 或系统 PATH 注册表项），你在终端能跑 php -v，IDE 却报 Cannot run program "php"，就是典型表现。
必须手动指定绝对路径，别信“自动检测”
PhpStorm 的 Interpreter 配置页里点“Browse”或“Auto-detect”，基本无效。你得自己把真实路径塞进去：
- macOS/Linux：在终端运行
which php，得到类似/opt/homebrew/bin/php或/usr/local/bin/php - Windows：运行
where php，常见结果是C:\php\php.exe或C:\phpstudy_pro\Extensions\php\php8.2.12\php.exe - 进
Settings → Languages & Frameworks → PHP → Interpreter→ 齿轮 →Add → Local→ 用文件选择器精准选中上面那个路径 - 选完立刻看右下角状态栏：必须显示
PHP x.x.x (cli)；不显示，说明路径错、文件无执行权限（Linux/macOS 需chmod +x），或 Windows 缺msvcr120.dll等运行时依赖
macOS 用户务必改用终端启动 PhpStorm
Dock 启动的 PhpStorm 永远不会加载 ~/.zshrc 里的 PATH，哪怕你 export 得再完整也没用。唯一可靠方式是：
- 终端执行
open -a PhpStorm（确保已添加到$PATH） - 或直接用完整路径启动，例如
open -a /Applications/PhpStorm.app - 这样启动的进程才能继承 shell 环境变量，
which php的结果才真正可用
Windows 要选 php.exe，不是 php-cgi.exe
PhpStorm 调试依赖 CLI SAPI，php-cgi.exe 是为 Web 服务器设计的，不支持交互式调试协议：
立即学习“PHP免费学习笔记（深入）”；
- 确认你选的是
php.exe（通常和php.ini在同一目录） - 如果用 phpStudy，路径常为
C:\phpstudy_pro\Extensions\php\php8.2.12\php.exe，别误选php-cgi.exe - 选完后在 PhpStorm 内置 Terminal 里运行
php --ini，验证是否真能调用——输出里Loaded Configuration File行不能是(none)
路径、启动方式、可执行文件类型这三处任一出错，php 就会彻底“消失”。很多人反复重装 PHP 或改环境变量，其实只是绕开了最直接的解决路径。
