Xdebug、WSL与VSCode调试异常：仍触发vendor目录异常追踪

1. 清理Xdebug 3冗余配置 #

你的php.ini里包含了Xdebug 2的废弃参数（remote_*开头），这些参数在Xdebug 3中已被替代，可能干扰调试逻辑，建议删除以下配置项：

xdebug.remote_autostart = "On"
xdebug.remote_enable = "On"
xdebug.remote_port=9003

保留Xdebug 3标准配置即可：

xdebug.mode = debug
xdebug.start_with_request = yes
xdebug.log_level=10
xdebug.show_error_trace=0
xdebug.client_port=9003
xdebug.idekey=VSCODE
xdebug.profiler_enable=0
xdebug.default_enable=0
xdebug.show_exception_trace=0

2. 优化launch.json配置 #

完善路径忽略规则 #

将ignore配置更精确，明确匹配vendor下的所有PHP文件：

"ignore": ["**/vendor/**/*.php"]

添加WSL路径映射 #

由于WSL和Windows的路径差异，VSCode可能无法正确识别忽略路径，添加pathMappings将WSL项目路径映射到VSCode工作区路径（替换为你的实际路径）：

{
  "name": "Listen for Xdebug",
  "type": "php",
  "request": "launch",
  "port": 9003,
  "ignore": ["**/vendor/**/*.php"],
  "pathMappings": {
    "/home/your-username/your-project": "${workspaceFolder}"
  },
  "stopOnEntry": false
}

3. 禁用VSCode全局异常断点 #

在VSCode调试侧边栏（快捷键Ctrl+Shift+D），展开「断点」面板，取消勾选PHP: 异常选项（若需捕获特定异常，可单独勾选对应类型），避免自动捕获vendor目录中抛出的所有异常。

4. 排查Xdebug日志定位问题 #

如果问题仍存在，可通过xdebug.log=/var/log/xdebug.log指定日志路径，查看日志中包含vendor的条目，确认具体是哪个文件抛出的异常，针对性调整忽略规则或修复代码逻辑。

5. 重启服务生效 #

修改配置后，重启WSL中的PHP-FPM（或Apache/Nginx）服务，同时重启VSCode，确保所有配置生效。

内容的提问来源于stack exchange，提问作者milanchee