PhpStorm找不到PHP或调试不触发，根本原因是GUI启动不继承shell环境变量，需用which php或where php获取绝对路径并在Settings→PHP→Interpreter中手动指定CLI解释器，并确保CLI对应的php.ini启用Xdebug且端口为9003。
PhpStorm 找不到 PHP 或调试不触发，90% 是解释器路径没对上，或 CLI 的 php.ini 没配 Xdebug —— 它根本不会读你终端里 PATH 里的 php，也不会自动加载 Apache 那套配置。
PHP 解释器路径为什么总配错
GUI 启动的 PhpStorm（比如 macOS 从 Dock 点开、Windows 双击快捷方式）压根不继承 shell 的 PATH，which php 在终端能跑，IDE 里照样报 Cannot run program "php"。
- 必须在终端里先执行
which php（macOS/Linux）或where php（Windows），拿到绝对路径，例如/opt/homebrew/bin/php或C:\php\php.exe - 进
Settings → Languages & Frameworks → PHP → Interpreter，点齿轮 →Add → Local，用文件选择器手动指向那个路径，别信“自动检测” - 配完右下角要显示类似
PHP 8.2.12 (cli)，否则就是路径无效、权限不足（Linux/macOS 缺chmod +x），或 Windows 缺运行时库（如msvcr120.dll） - Mac 用户若用 Homebrew 安装 PHP，用 Dock 启动 PhpStorm 时，
~/.zshrc里的export PATH不生效；改用终端命令open -a PhpStorm启动才能继承环境
CLI 和 Web 的 php.ini 根本不是同一个文件
你在浏览器里打开 phpinfo() 看到的 Loaded Configuration File，和 PhpStorm 调用 CLI 时用的根本无关。Xdebug 配在 Apache 的 php.ini 里，对 PhpStorm 调试完全无效。
- 在 PhpStorm 内置 Terminal 里执行
php --ini，盯住Loaded Configuration File:那行输出，才是你要改的文件 - 常见位置：
/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 最小必要配置就三行，写进这个 CLI 的
php.ini：zend_extension=xdebugxdebug.mode=debugxdebug.client_host=127.0.0.1
端口默认是9003，别写成旧版9000 - 改完执行
php -m | grep xdebug，有输出才说明扩展已加载；没输出就检查extension_dir下是否存在xdebug.so或php_xdebug.dll
服务器映射不对，断点永远不命中
点了 Start Listening for PHP Debug Connections，断点也打了，但请求一发过去 IDE 就没反应——大概率是 Server Configuration 里的路径映射没对上，Xdebug 发来的调试连接被 PhpStorm 当成未知来源直接丢弃了。
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings → Languages & Frameworks → PHP → Servers，确认已添加对应本地服务（如http://localhost） - 关键：勾选
Use path mappings，然后把「项目根目录」映射到「Web 服务器文档根目录」，例如：
Local path:$PROJECT_DIR$
Absolute path on server:/var/www/html（Linux）或C:\xampp\htdocs（Windows） - 如果用 PhpStorm 内置 Web Server（
Run → Run...），映射路径通常是http://localhost:63342/your-project/，对应本地路径必须严格匹配 - 改完重启 PhpStorm，再试一次；仍不行就看
phpinfo()输出里xdebug.client_host和xdebug.client_port是否与 PhpStorm 的PHP → Debug设置一致
Composer 命令找不到，Xdebug 日志查不到问题
PHPStorm 默认不复用 shell 的环境变量，composer 报 command not found 是常态；同理，Xdebug 不打日志，你就只能靠猜。
- 进
Settings → Languages & Frameworks → PHP → Composer，勾选Use composer executable，填which composer的结果，例如/opt/homebrew/bin/composer；Windows 上慎用带空格路径（如C:\Program Files\...），会静默失败 - 要查 Xdebug 底层通信，得在 CLI 的
php.ini里加一行：xdebug.log="/tmp/xdebug.log"（Linux/macOS）或xdebug.log="C:\temp\xdebug.log"（Windows） - 日志打开后，触发一次调试请求，再看日志里有没有
Connecting to configured address/port或Connection refused这类关键信息 - 更底层的问题可开 PhpStorm 调试日志：
Help → Diagnostic Tools → Debug Log Settings…，加一行#com.jetbrains.php.debug，重现问题后查idea.log
最常被跳过的动作是：没验证 php --ini 输出的到底是哪个 php.ini，就凭感觉去改；或者改了 Apache 的配置，却指望 CLI 调试生效。路径、SAPI 类型、配置文件归属，三者必须咬死对齐，少一个环节都会卡住。
