xdebug不触发断点需先确认xdebug.mode=debug已启用，再核对php.ini路径、pathmappings映射、xdebug.start_with_request配置及端口一致性。
VSCode里Xdebug不触发断点？先确认xdebug.mode设对了
WordPress是PHP脚本驱动的，Xdebug 3之后必须显式启用调试模式，光靠xdebug.remote_enable=1这种旧配置完全无效。常见现象是VSCode里打了断点，但请求一跑就过，毫无反应。
-
xdebug.mode必须包含debug，比如xdebug.mode=debug,develop（develop可选，用于显示错误堆栈） - 如果用的是Docker或MAMP/XAMPP，要确认修改的是**实际被PHP加载的php.ini**，不是编辑器里随便打开的那个文件
- Windows下路径带空格（如
C:\Program Files\...）会导致Xdebug加载失败，错误信息通常是Failed loading xdebug，建议把PHP和Xdebug装到短路径如C:\php - 用
php -v和php --ini双重验证Xdebug是否真的在运行、配置文件位置是否正确
launch.json里pathMappings配错，断点永远灰色
VSCode无法把服务器上的文件路径映射到你本地项目目录，就会找不到源码，断点变灰色——这是WordPress调试最常卡住的地方。尤其当你用Docker、Vagrant或远程WAMP时，路径结构天然不一致。
- WordPress根目录在容器里可能是
/var/www/html，而你本地是D:\projects\mywp，那pathMappings就得写成"\/var\/www\/html": "${workspaceFolder}" - 注意斜杠方向：Linux/macOS路径用
/，Windows本地路径也统一用/（VSCode自动处理），别混用\ - 如果主题或插件在
wp-content外单独开发（比如用composer create-project拉的Bedrock），要为每个独立目录单独加映射项 - 配完后启动调试，看VSCode底部状态栏是否显示
Xdebug listening，再检查Debug Console里有没有Could not map file警告
WordPress后台/REST API/XHR请求进不了断点？试试xdebug.start_with_request
默认情况下，Xdebug只响应带XDEBUG_SESSION_START参数或Cookie的请求。但WordPress后台AJAX、REST接口、WP-CLI命令这些，往往没手动加调试开关，自然不触发。
- 设
xdebug.start_with_request=yes可强制所有请求都进入调试（开发机可用，勿上生产） - 更安全的做法是配合浏览器插件（如Xdebug Helper），点击图标后自动加Cookie，再刷后台页面
- WP-CLI调试需额外加环境变量：
XDEBUG_MODE=debug php wp-cli.phar rewrite structure '/%postname%/' - 注意：某些CDN或反向代理（如nginx的fastcgi_param）会过滤掉
XDEBUG_*头，此时start_with_request是唯一可靠方式
断点进了，但$wp_query或get_posts()变量显示undefined？别急着换扩展
这不是Xdebug问题，是VSCode PHP Debug扩展对WordPress全局对象支持有限。它能停住，但变量面板里看不到动态构建的全局变量，容易误判为“没加载”。
- 优先用
var_dump()或error_log(print_r($wp_query, true), 3)输出到日志，比依赖UI更可靠 - 确保
launch.json中port与xdebug.client_port一致（默认9003），端口被占用会导致连接中断，变量加载不全 - 避免在
wp-config.php顶部过早调用define('WP_DEBUG', true)——它可能干扰Xdebug初始化顺序 - 如果用的是较新版本WordPress（6.0+）且启用了Block Themes，
template_redirect钩子时机可能比预期早，断点建议下在wp或wp_loaded动作里
WordPress的钩子机制和动态加载让调试链路比普通PHP脚本长得多，一个断点背后可能跨了十几层include。别指望一次配完就万事大吉，每次换环境、升级PHP或切分支，都要重新核对php.ini路径、pathMappings和Xdebug版本兼容性。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
