PhpStorm找不到php命令的根本原因是GUI启动时未加载shell的PATH环境变量，需通过终端命令启动（macOS）或手动指定php绝对路径，并确保CLI与Web SAPI使用匹配的php.ini及正确路径映射。
PhpStorm找不到php命令，根本原因是没继承shell的PATH
终端里php -v能跑，但PhpStorm报Command 'php' not found或PHP executable not found，不是路径写错了，而是它压根没加载你的$PATH。macOS/Linux尤其明显——Dock启动、GUI快捷方式启动时，环境变量是空的。
- 别在Interpreter字段里填
php（不带路径），这只会让PhpStorm去系统默认路径找，而现代PHP基本不在/usr/bin/php - 先在终端执行
which php（macOS/Linux）或where php（Windows），拿到真实路径，比如/opt/homebrew/bin/php或C:\xampp\php\php.exe - Mac用户若用Homebrew装PHP，必须用终端命令启动PhpStorm：
open -a "PhpStorm.app" --args，否则它永远读不到你的zsh/bash profile - Windows用户注意：XAMPP/WAMP里要选
php.exe，不是php-cgi.exe——后者没有CLI支持，调试会直接失效
多个PHP版本共存时，怎么按项目切解释器
一个项目用PHP 8.1，另一个要测PHP 7.4插件？不能全局切换，得每个项目单独配解释器。PhpStorm不会自动识别你装了几个PHP，它只显示你手动添加过的那些。
- 进项目Settings →
Languages & Frameworks→PHP→Interpreter，点齿轮→Add→Local - 手动浏览选择对应版本的
php二进制文件，比如/usr/local/bin/php@7.4或C:\php\7.4\php.exe - 添加后下拉框里会出现带路径标识的选项，如
PHP 7.4.33 (/usr/local/bin/php)，选中即可 - CLI解释器和Web服务器解释器是两回事：内置服务器（Run → Run 'index.php'）走这里配的CLI；Apache/Nginx访问走的是它们自己的PHP模块，跟PhpStorm无关
为什么配置完还是断点不触发？可能php.ini没对上
PhpStorm调用的是CLI模式的PHP，但很多人只改了Apache或FPM的php.ini，CLI用的是另一套配置。Xdebug断点失效，90%出在这里。
- 在PhpStorm内置Terminal里运行
php --ini，确认Loaded Configuration File路径，常见位置：/etc/php/8.2/cli/php.ini（Linux）或C:\php\php.ini（Windows） - 编辑那个文件，加入Xdebug 3标准配置：
xdebug.mode=debug、xdebug.client_host=127.0.0.1、xdebug.client_port=9003 - 别漏掉
xdebug.start_with_request=yes，否则得手动触发调试 - 改完重启PhpStorm（不是重载项目），并在
Run→Start Listening for PHP Debug Connections开启监听
路径映射配错，浏览器打开就404
解释器配好了，Xdebug也开了，但点“Open in Browser”弹出404？这是Servers里的路径映射没对齐，和解释器无关。
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings → Languages & Frameworks → PHP → Servers，点+添加服务器 -
Host填localhost（别写127.0.0.1，Xdebug默认只认localhost） -
Local path填项目根目录绝对路径，比如/Users/name/www/blog -
Web path必须严格匹配Web服务器DocumentRoot下的子目录名：项目放在htdocs/blog，就填/blog；放htdocs根下，就填/ - 务必勾选
Use path mappings，否则下面的映射列表灰掉不可用
php.ini，或者路径映射里的Web path和服务器真实URL结构不一致——这两个点一错，前面所有配置都白搭。 
