根本原因是GUI启动不继承shell环境变量，需用which php或where php获取绝对路径后，在Settings→PHP→Interpreter中手动指定；macOS须用open -a PhpStorm启动，Windows需选php.exe而非php-cgi.exe。
PhpStorm找不到php命令，根本原因不是IDE坏了
它压根没读你终端里配好的PATH——尤其是 macOS 用 Dock 启动、Windows 用快捷方式启动时，GUI 进程根本不加载 shell 的环境变量。别试“自动检测”，那只是摆设。
必须手动定位真实路径：
- macOS/Linux：在终端运行
which php，典型输出如/opt/homebrew/bin/php（M1/M2）或/usr/local/bin/php（Intel） - Windows：运行
where php，常见路径如C:\php\php.exe或C:\xampp\php\php.exe - 选完路径后，右下角要显示类似
PHP 8.2.12 (cli)才算成功；若报Cannot run program "php"，八成是权限问题（Linux/macOS 需chmod +x /path/to/php）或路径指向了目录而非可执行文件
phpinfo() 和 PhpStorm 里 php -v 显示不同配置，很正常
Web SAPI（Apache/Nginx 加载的 PHP）和 CLI（命令行）默认用两套 php.ini 文件。PhpStorm 调用的是 CLI 版本，所以你在 /etc/php/8.2/apache2/php.ini 里加了 Xdebug，对它完全无效。
确认 PhpStorm 实际加载哪个配置：
立即学习“PHP免费学习笔记（深入）”；
- 在 PhpStorm 内置 Terminal 里执行
php --ini，看输出的Loaded Configuration File路径 - 常见 CLI 配置位置：
/etc/php/8.2/cli/php.ini（Ubuntu）、/opt/homebrew/etc/php/8.2/php.ini（Mac Homebrew）、C:\php\php.ini（Windows） - 编辑对应文件，加入 Xdebug 3 最小配置（仅三行起效）：
zend_extension=xdebugxdebug.mode=debugxdebug.client_host=127.0.0.1
端口默认9003，别写旧版9000
断点打了，“Start Listening for PHP Debug Connections”也点了，但就是不中断
Xdebug 发起的调试连接被 PhpStorm 当成未知请求丢弃了——90% 是服务器路径映射没对上。
检查三项硬性匹配：
- PhpStorm 中
Settings → PHP → Servers添加的服务器名，必须和浏览器访问 URL 的 host 一致（比如填localhost，就别用127.0.0.1） - “Absolute path on server” 必须精确到项目根目录，例如
/var/www/myproject，不能多一个斜杠或少一个字母 - 浏览器插件（如 Xdebug Helper）里设置的 IDE key 必须是
PHPSTORM（大小写敏感），且启用 “Debug” 模式
Composer 在 PhpStorm 里报 command not found
GUI 启动的 PhpStorm 不继承 shell 的 PATH，它不会自动从环境变量里找 composer。
解决方案只有一条路：
- 运行
which composer（macOS/Linux）或where composer（Windows），拿到绝对路径，如/opt/homebrew/bin/composer或C:\Users\YourName\scoop\shims\composer.bat - 进
Settings → Languages & Frameworks → PHP → Composer，勾选Use composer executable，粘贴上面的路径 - Windows 上避免用带空格的路径（如
C:\Program Files\...），PhpStorm 会静默失败；Scoop 用户优先用scoop\shims\composer.bat
