Xdebug在WAMP下默认不启用，需手动修改Apache所用php.ini（通过WAMP托盘→PHP→php.ini打开），添加zend_extension绝对路径及xdebug.mode=debug等新参数，重启所有服务后在phpinfo()中验证完整Xdebug区块，并在PhpStorm中配置服务器映射与端口监听。
Xdebug 在 WAMP 下默认不启用，必须手动修改 php.ini 并重启服务，否则 phpinfo() 里根本不会显示 Xdebug 模块。
确认当前生效的 php.ini 文件路径
WAMP 会加载两个位置的 php.ini：一个是 CLI（命令行）用的，另一个是 Apache 模块用的。调试 PHP Web 请求时，必须改 Apache 对应的那个。
打开浏览器访问 http://localhost/?phpinfo=1，搜索 Loaded Configuration File 这一行——它显示的路径才是你要编辑的文件，比如：C:\wamp64\bin\php\php8.2.12\php.ini。
常见错误：直接去 C:\wamp64\bin\php\php.ini 改，这个路径通常不存在或不是实际加载的配置文件。
- 右键 WAMP 托盘图标 → PHP → php.ini，这是最稳妥的打开方式
- 改完保存后，务必右键托盘图标 → Restart All Services，只重启 Apache 不够，PHP 模块依赖整个服务链
- 如果改完没反应，检查 Windows 是否以只读方式打开了该文件（尤其从 ZIP 解压后）
添加 zend_extension 和基础调试配置
新版 Xdebug（3.0+）不再支持 xdebug.remote_* 系列旧参数，必须用 xdebug.mode 控制行为；WAMP 自带的 PHP 8.0+ 默认配的是新语法，但老教程常混用旧写法，导致静默失效。
在 php.ini 文件末尾追加以下内容（注意路径替换成你本地 php_xdebug.dll 的真实位置）：
zend_extension="C:\wamp64\bin\php\php8.2.12\ext\php_xdebug.dll" xdebug.mode=debug xdebug.client_host="127.0.0.1" xdebug.client_port=9003 xdebug.start_with_request=yes
关键点：
Xdebug 3.4.1 是一款功能强大的 PHP 调试扩展工具，于 2025 年 1 月 6 日正式发布。作为 Xdebug 3.4 系列的首个修复版本，3.4.1 版在继承上一版本强大功能的同时，重点解决了稳定性问题。该版本不仅修复了访问超全局变量时可能引发的程序崩溃现象，还增强了对 Windows 平台 PIE 构建机制的支持，为广大 PHP 开发者提供了更加稳定的调试环境。这一版本适合所有
-
zend_extension路径必须绝对、正确，且 DLL 文件确实存在；WAMP 通常已自带该文件，不用额外下载 -
xdebug.client_port默认是9003（不是旧版的9000），PhpStorm 默认监听此端口，若改了要同步调 PhpStorm 设置 -
xdebug.start_with_request=yes表示每次 HTTP 请求自动启动调试，省得手动加?XDEBUG_SESSION_START=1 - 不要同时写
xdebug.remote_enable=1这类已被废弃的参数，Xdebug 3 会忽略并可能报错
验证 Xdebug 是否真正加载成功
重启服务后，再次打开 http://localhost/?phpinfo=1，页面内搜索 xdebug，应看到完整区块，包含 Version、mode、client_host 等字段。
容易被忽略的失败信号：
- 页面有
xdebug字样但只有几行（比如只显示zend_extension加载路径），说明扩展加载失败，大概率是 DLL 路径错或版本不匹配 - 搜索不到任何
xdebug，先确认是否改对了php.ini（见第一个副标题），再检查 Apache 错误日志：C:\wamp64\logs\apache_error.log，里面常有PHP Warning: Cannot load module 'xdebug'类提示 - 即使
phpinfo()显示正常，PhpStorm 仍连不上，重点查xdebug.client_host是否为"127.0.0.1"（不能写成localhost或留空），以及 Windows 防火墙是否拦截了9003端口
PhpStorm 中的配套设置要点
光配好 PHP 端不够，IDE 必须能接收连接，否则断点永远不触发。
进入 PhpStorm → Settings → PHP → Servers，添加一个 Server：
-
Name填任意，如localhost -
Host填localhost，Port填80（WAMP 默认） - 勾选
Use path mappings，然后映射：Project files→C:\wamp64\www（或你实际的 www 目录）
然后打开 Run → Start Listening for PHP Debug Connections（小电话图标），确保状态为绿色。
最后测试：在 PHP 文件里打个断点，浏览器访问对应 URL，PhpStorm 应弹出 “Incoming Connection from Xdebug” 提示——这才是真通了。
复杂点在于：WAMP 多 PHP 版本切换时，php.ini 路径和 php_xdebug.dll 位置都会变，每次切版本都要重新核对一次路径，不能想当然复用上一个版本的配置。
