PHP解释器路径须手动指定，CLI与Web的php.ini独立；Xdebug 3需配CLI版php.ini，启用debug模式、client_host/port，并在PhpStorm中正确配置Servers路径映射及浏览器Xdebug Helper插件。
PHP 解释器路径必须手动指定，不能依赖系统 PATH
PhpStorm 启动时不会加载 shell 的环境变量，尤其是 macOS 用 Dock、Windows 用快捷方式启动时，which php 或 where php 在终端里能用，但在 PhpStorm 里完全无效。它根本找不到 php 命令，导致 php -v 报错、phpinfo() 不生效、Xdebug 断点不触发。
- 先在终端执行
which php（macOS/Linux）或where php（Windows），拿到绝对路径，例如/usr/local/bin/php或C:\php\php.exe - 进 Settings → PHP → Interpreter → 点齿轮 → Add → Local → 浏览并选中该路径，不是“自动检测”
- 选完后右下角必须显示类似
PHP 8.2.12 (cli)，否则说明路径错误、权限不足，或缺失运行依赖（如 Windows 缺msvcr120.dll）
CLI 和 Web SAPI 的 php.ini 完全是两套，Xdebug 必须配 CLI 版
你在 /etc/php/8.2/apache2/php.ini 里加了 Xdebug，对 PhpStorm 没任何作用——它调用的是 CLI 版本，只认 /etc/php/8.2/cli/php.ini 或 C:\php\php.ini。配错位置，php -m | grep xdebug 就永远不输出结果。
- 在 PhpStorm 内置 Terminal 中运行
php --ini，确认它实际加载的Loaded Configuration File路径 - 编辑那个文件，在末尾添加 Xdebug 3 配置（注意不是 Xdebug 2）：
zend_extension=xdebugxdebug.mode=debugxdebug.start_with_request=yesxdebug.client_host=127.0.0.1xdebug.client_port=9003 - 改完重启 PhpStorm，再跑
php -m | grep xdebug验证是否加载成功
Servers 映射不对，Xdebug 连接直接被丢弃
点了 “Start Listening for PHP Debug Connections”，断点也打了，但就是不中断——八成是服务器映射没对上。Xdebug 发来的调试请求发到了 PhpStorm，但它不知道该归哪个项目管，直接丢弃。
- 进 Settings → Languages & Frameworks → PHP → Servers → + 添加服务器
- Host 填
localhost，Port 填你 Web 服务的实际端口（通常是80，若用8080就填8080） - 务必勾选
Use path mappings，把本地项目根目录（如C:\xampp\htdocs\myproject）映射到对应 Web 路径（如/myproject），不能留空或填错斜杠方向 - 映射关系必须和浏览器访问 URL 一致，比如你访问的是
http://localhost/myproject/index.php，那 Web 路径就必须是/myproject
调试监听开启后仍不触发，检查 Xdebug Helper 插件和 IDE Key
即使解释器、php.ini、Servers 全配对了，断点还是不进，大概率是浏览器没发带调试参数的请求，或者 PhpStorm 没认出这个请求来自你当前项目。
立即学习“PHP免费学习笔记（深入）”；
- 浏览器安装
Xdebug Helper插件（Chrome/Firefox 均有），点击图标启用调试模式 - 确保插件右键菜单里 IDE Key 是
PHPSTORM（Xdebug 3 默认值，不用额外设；旧版 Xdebug 2 可能需手动填） - 访问 URL 时，插件会自动追加
?XDEBUG_SESSION_START=PHPSTORM参数，这是触发调试的唯一可靠方式 - 别依赖
xdebug.start_with_request=yes全局开启——它在 CLI 下有效，但在 Web 请求中仍需明确触发，否则多数 Web 服务器（尤其 Nginx）会忽略
9003，不是旧版的 9000；映射路径里的斜杠方向、大小写、结尾是否带斜杠，都会让调试静默失败；CLI php.ini 和 Web php.ini 的差异，是最常被跳过的验证环节。 
