必须手动指定真实php可执行文件路径，否则断点不触发、$_GET为空、调试静默失效；需用which php或where php获取路径，填入PhpStorm并验证版本与扩展，确保php.ini中xdebug.mode=debug、client_port=9003与PhpStorm端口一致，严格配置Servers路径映射，并用phpinfo()和断点验证全链路。
必须手动指定系统中真实可执行的 php.exe 或 php 文件路径，否则断点不触发、$_GET 为空、调试器完全静默——这不是 PhpStorm 的 Bug，而是它根本没在用你以为的那个 PHP。
怎么确认并填对 PHP 解释器路径
PhpStorm 不会自动猜路径，也不读系统 PATH 环境变量来启动调试进程。
- 先在终端运行
which php（macOS/Linux）或where php（Windows），拿到输出的真实路径；别信“看起来像”的路径，比如C:\Program Files\php\php.exe因空格和权限大概率失败 - 路径必须是可执行文件本身，不是目录，也不能是批处理脚本（如某些集成环境带的
php.bat） - 填完后 PhpStorm 右下角状态栏应显示 PHP 版本号；若显示
Invalid interpreter，检查文件权限（Linux/macOS 需chmod +x）或是否被杀毒软件拦截（Windows 常见） - 多版本共存时（如 asdf/phpbrew），确保选的是当前 shell 中
php -v输出的那个版本，不是全局默认但未激活的版本
Xdebug 3 的配置必须和 PhpStorm 端口严格对齐
Xdebug 3 默认端口是 9003，不是旧版的 9000；只要有一处写错，连接就静默断开。
- 在
php.ini中启用 Xdebug 扩展：Windows 写完整路径zend_extension=C:\php\ext\php_xdebug.dll，Linux/macOS 写zend_extension=xdebug.so - 关键参数必须成对出现：
xdebug.mode=debug+xdebug.start_with_request=yes（自动触发）或trigger（需 URL 加?XDEBUG_SESSION_START=PHPSTORM） -
xdebug.client_port=9003必须和 PhpStorm 的Settings → PHP → Debug → Xdebug → Debug port完全一致 - 改完
php.ini后，CLI 下运行php --ini确认生效的是哪个文件；Web 下用phpinfo()检查 Xdebug 是否加载、参数是否生效
Servers 路径映射缺失会导致断点永远不命中
即使解释器和 Xdebug 都对，没有正确设置 Servers，PhpStorm 就不知道浏览器请求该对应到你本地哪个文件——断点图标会变灰，点击也无效。
立即学习“PHP免费学习笔记（深入）”；
- 进入
Settings → Languages & Frameworks → PHP → Servers，添加一个新服务器，Host 填localhost，Port 填实际 Web 服务端口（如 Apache 是80，Nginx 是8080） - 务必勾选
Use path mappings，然后把你的项目根目录（如D:\project）映射到 Web 根路径（如/或/public） - 如果用 phpStudy/XAMPP，映射目标通常是
C:\phpstudy_pro\WWW或C:\xampp\htdocs；路径错误会导致“File not found”或跳转到错误位置 - 验证方式：在浏览器访问
http://localhost/test.php，同时在 PhpStorm 中打个断点，看是否停住；不停，优先检查映射路径是否漏掉末尾斜杠或大小写不一致
运行方式选错会让调试形同虚设
右键 Run 和 Debug 是两套逻辑，混用就会出现“控制台有输出但断点不进”或“浏览器打不开却还在等响应”。
- 想测路由、API、HTML 渲染，必须用
PHP Web Page类型，并关联上面配好的Servers；用PHP Script类型只会走 CLI，$_SERVER极简，$_GET为空 - 临时配置（右键 → Run）默认是
PHP Script，要调试 Web 请求，必须进Run → Edit Configurations改类型，并指定 Server - 调试前必须点击右上角电话图标
Start Listening for PHP Debug Connections，否则 PhpStorm 根本不监听 DBGP 连接 - 浏览器需配合插件（如 Xdebug Helper）或手动加
?XDEBUG_SESSION_START=PHPSTORM，否则 Xdebug 不知道该连谁
最常被忽略的是：改了 php.ini 没重启 Web 服务，或用了 CLI 的 php -S 内置服务器却没在 Servers 里配好映射——这两处一错，整个调试链就断在中间，现象全是“没反应”，但错误日志里什么都不会报。
