能跑起来、能断点、能提示三者缺一不可；90%失败因只完成部分配置，如仅设解释器未启Xdebug，或Xdebug已配但PHPStorm未监听端口，或路径映射不一致导致断点不触发。
能跑起来、能断点、能提示，三件事缺一不可——配置失败90%是因为只做了其中一两步，比如只配了解释器却没启用 Xdebug，或者配了 Xdebug 但 PhpStorm 没监听端口。
PHP 解释器路径必须指向真正的 php.exe 或 php
PhpStorm 不自带 PHP，它只调用你本地的解释器。路径错、权限不足、版本太旧都会导致 php -v 在终端能运行，但在 PhpStorm 里报 Cannot resolve PHP executable。
- Windows 下常见错误路径：
C:\xampp\php（少写了php.exe）→ 正确应为C:\xampp\php\php.exe - macOS/Linux 下别用 alias 或 shell wrapper，要找真实二进制路径，运行
which php确认 - 如果用了 Homebrew 安装 PHP，路径可能是
/opt/homebrew/bin/php（Apple Silicon）或/usr/local/bin/php（Intel），php --ini能帮你定位实际加载的php.ini
Xdebug 3 必须在 php.ini 里显式启用 mode 和 client_port
新版 Xdebug（3.x）默认关闭所有功能，光写 zend_extension=xdebug 不够，xdebug.mode=debug 才是开关。
- 关键配置项（必须全部存在）：
xdebug.mode=debug、xdebug.start_with_request=yes（或trigger）、xdebug.client_host=127.0.0.1、xdebug.client_port=9003 - Windows 用户注意：扩展名是
php_xdebug.dll，路径要带引号，例如：zend_extension="C:\xampp\php\ext\php_xdebug.dll" - 配完后务必重启 Web 服务（Apache/Nginx）或 CLI 进程，否则
phpinfo()里看不到 Xdebug 模块
PhpStorm 的 Debug Listener 和 Server 映射必须匹配
即使 Xdebug 已加载、端口也通，如果 PhpStorm 没监听，或服务器映射路径不一致，断点永远不触发。
立即学习“PHP免费学习笔记（深入）”；
- 启动监听：点击右上角电话图标（
Start Listening for PHP Debug Connections），图标变绿才算激活 - Server 配置位置：
Settings → PHP → Servers，Host 填localhost，Port 填你 Web 服务实际监听的端口（如 Apache 是 80，Nginx 是 8080） - Path mappings 是硬伤点：本地项目路径（如
/Users/me/project）必须和 Web 服务器看到的路径（如/Applications/XAMPP/htdocs/project）一一对应，否则断点找不到文件
最容易被忽略的是 php.ini 加载路径和 PhpStorm 实际读取的不是同一个文件——尤其当你同时装了多个 PHP（XAMPP、Homebrew、Docker），php --ini 输出的 Loaded Configuration File 才是唯一可信依据。
