PhpStorm不会自动继承终端PATH，必须手动指定php绝对路径：先用which php或where php获取路径，再在Settings→PHP→Interpreter中添加；macOS需用open -a PhpStorm启动，Windows路径不能含空格，CLI与Web使用不同php.ini，Xdebug须配置在CLI版php.ini中且端口为9003。
PhpStorm 不会自动继承你在终端里配置好的 PATH，所以“终端能跑 php -v”和“PhpStorm 能用 PHP”完全是两回事。必须手动指定绝对路径，否则 Ctrl+Shift+F10 直接报错 No executable file found。
怎么拿到正确的 php 可执行文件路径
别抄网上随便搜的路径，也别信 PhpStorm 的“自动检测”。打开你日常用的终端（不是 PowerShell、不是 Git Bash 假终端），执行：
which php（macOS/Linux）或 where php（Windows CMD/PowerShell）
输出就是你要的真实路径，例如：
立即学习“PHP免费学习笔记（深入）”；
/opt/homebrew/bin/php（Apple Silicon Homebrew）、/usr/local/bin/php（Intel Mac）、C:\php\php.exe（Windows 独立安装）
注意：XAMPP/WAMP 用户务必选 php.exe，不是 php-cgi.exe；系统自带 /usr/bin/php 已被弃用，别用。
在 PhpStorm 里填路径时容易踩的坑
路径填错、权限不对、启动方式不对，三者占配置失败的 95%：
- Settings → Languages & Frameworks → PHP → Interpreter → 齿轮 → Add → Local → 手动点击「…」选中上面拿到的
php文件（不是文件夹，不是php.ini） - 选完立刻看右下角是否显示类似
PHP 8.2.12 (cli)；不显示就说明路径无效 - Linux/macOS 下如果提示权限不足，运行
chmod +x /path/to/php - macOS 用 Dock 启动 PhpStorm → 它不读
~/.zshrc→ 改用终端执行open -a PhpStorm启动 - Windows 路径含空格（如
C:\Program Files\php\php.exe）会导致静默失败，换到C:\php\php.exe这类干净路径
为什么填对了路径，phpinfo() 和 PhpStorm 显示的配置还不一样
因为 Web（Apache/Nginx）和 CLI（命令行）用的是两套 php.ini，而 PhpStorm 默认调用 CLI 版本：
在 PhpStorm 内置 Terminal 里运行 php --ini，看它实际加载的是哪个文件（常见路径：/etc/php/8.2/cli/php.ini 或 C:\php\php.ini）
Xdebug 必须装在这个 CLI 对应的 php.ini 里，不是你浏览器里 phpinfo() 显示的那个。最小必要配置只有三行：
zend_extension=xdebugxdebug.mode=debugxdebug.client_host=127.0.0.1
端口默认是 9003，别写成旧版 9000。
配置完仍报 “PHP executable not found”
这不是 PhpStorm 找不到 php，而是它根本没加载你的 shell 环境变量 —— 尤其当你用 GUI 方式（Dock/快捷方式）启动时，$PATH 是空的。
验证方式：在 PhpStorm 内置 Terminal 里直接敲 php -v，如果报 command not found，说明解释器路径虽设了，但 CLI 环境本身不可用。
此时唯一可靠解法：关掉 PhpStorm，从已加载完整 PATH 的终端启动它（macOS：open -a PhpStorm；Windows：用 CMD 启动 phpstorm64.exe）。
复杂点在于：路径、权限、启动方式、php.ini 分离、Xdebug 端口，四个环节任一出错都会卡住，且错误提示不指向真实原因。
