PhpStorm不运行PHP，仅调用本地php二进制文件；配置失败主因是GUI启动未继承shell环境变量，须用which php或where php获取绝对路径手动配置，并确保CLI php.ini启用Xdebug且端口为9003。
PhpStorm 本身不运行 PHP，它只调用你本地的 php 二进制文件；配置失败的主因不是 PhpStorm 坏了，而是它压根没读到你终端里配好的 PATH —— 尤其是 macOS 从 Dock 启动、Windows 用快捷方式启动时，GUI 进程根本没加载 shell 的环境变量。
怎么找对 php 可执行文件路径
别信 Settings 里“自动检测”按钮。必须手动定位真实路径：
- macOS/Linux：在终端运行
which php，典型输出如/opt/homebrew/bin/php或/usr/local/bin/php - Windows：在 CMD 或 PowerShell 运行
where php，常见路径是C:\php\php.exe、C:\xampp\php\php.exe或D:\phpstudy_pro\Extensions\php\php8.2.12\php.exe - 选完路径后，PhpStorm 右下角必须显示类似 “PHP 8.2.12 (cli)” 的字样；不显示说明路径错、权限不足，或该
php缺依赖（比如 Windows 缺msvcr120.dll）
为什么 phpinfo() 和 CLI 显示的配置不一致
Web SAPI（Apache/Nginx 加载的 PHP）和 CLI（命令行）默认用两套 php.ini 文件。PhpStorm 调用的是 CLI 版本，所以你在 /etc/php/8.2/apache2/php.ini 里加的 xdebug，对 PhpStorm 完全无效。
验证当前 CLI 加载的是哪个配置：
立即学习“PHP免费学习笔记（深入）”；
- 在 PhpStorm 内置 Terminal 里运行
php --ini - 重点看 “Loaded Configuration File” 行，常见路径是：
/etc/php/8.2/cli/php.ini（Linux/macOS）、C:\php\php.ini（Windows） - 编辑这个文件，追加 Xdebug 3 配置（注意版本匹配）：
zend_extension=xdebug<br>xdebug.mode=debug<br>xdebug.start_with_request=yes<br>xdebug.client_host=127.0.0.1<br>xdebug.client_port=9003
- 改完重启 PhpStorm，再运行
php -m | grep xdebug确认扩展已加载
服务器路径映射配错，断点永远不触发
点了 “Start Listening for PHP Debug Connections”，断点也打了，但就是不中断——大概率是服务器映射没对上，Xdebug 发起的调试连接被 PhpStorm 当成未知请求丢弃了。
- 进入 Settings → Languages & Frameworks → PHP → Servers，点击 “+” 添加服务器
- Host 填
localhost，Port 填实际 Web 服务端口（通常是80或8080） - 务必勾选 “Use path mappings”，然后把你的项目根目录（如
D:\phpstudy_pro\WWW\myapp）映射到 Web 路径（如/myapp），而不是粗暴映射到/ - 如果用的是内置 PHP Server（
php -S），Host 必须填127.0.0.1，不能用localhost（DNS 解析可能绕过监听）
最常被忽略的一点：Xdebug 3 的 xdebug.client_port 默认是 9003，但 PhpStorm 的 Debug 设置里仍可能残留旧版的 9000；两个端口不一致，连接直接被拒绝，连错误提示都不给。
