断点不暂停的主因是xdebug未正确启用、端口不匹配或路径映射错误；需验证xdebug加载与版本兼容性，配置xdebug.mode=debug及client_host/client_port，安装php debug插件并正确设置launch.json的pathmappings，通过url参数或xdebug helper触发调试，最后用xdebug.log排查连接问题。
断点不暂停？先确认 Xdebug 是否真在跑
VSCode 里点了断点却毫无反应，大概率不是 VSCode 的问题，而是 PHP 进程压根没把调试信息发出来。最直接的验证方式是终端执行 php -v，输出里必须带 with Xdebug；再跑一遍 php --ri xdebug，看 Version 字段是不是 3.x（PHP 8.0+ 必须用 Xdebug 3），且 Supports phpinfo() 是 enabled。如果 php -m | grep xdebug 没输出，说明扩展根本没加载——别急着配 launch.json，先回去检查 php.ini 里的 zend_extension 路径对不对、有没有被注释、有没有重复加载。
php.ini 配置写错一个字母，整个调试链就断掉
Xdebug 3 和旧版参数名完全不同，混用或拼错会导致静默失败。关键几项必须同时存在且无多余空格或中文标点：
-
xdebug.mode=debug（不是remote_enable，也不是on） -
xdebug.start_with_request=trigger（推荐，避免全站请求都进调试器） -
xdebug.client_host=127.0.0.1（不是 localhost，某些 DNS 解析下会失败） -
xdebug.client_port=9003（Xdebug 3 默认端口，不是 9000；改了就得同步改 VSCode） -
xdebug.idekey=VSCODE（和launch.json里ideKey或默认值匹配）
改完 php.ini 后，Apache/Nginx + PHP-FPM 都得重启，光重启 Web 服务不够，PHP-FPM 进程可能还缓存着旧配置。
launch.json 的 pathMappings 是路径映射，不是文件夹别名
pathMappings 的左右两边必须是**绝对路径**，且左侧是 PHP 实际运行时看到的路径（比如 /var/www/html/ 或 C:\xampp\htdocs\），右侧是你的本地项目根目录（${workspaceFolder}）。常见错误：
- 左边写成
./或src/—— Xdebug 不认识相对路径 - 右边漏掉末尾斜杠，比如写成
"${workspaceFolder}"而不是"${workspaceFolder}/"，某些系统下映射失败 - 项目在 Docker 或远程服务器上，左边路径没按容器内真实路径写（例如
/app/）
不确定左边路径？在 PHP 文件里加一行 echo __DIR__;，访问页面看输出，抄下来填进 pathMappings 左侧。
触发调试不能只靠 URL 参数，还得看 IDE Key 是否匹配
加 ?XDEBUG_SESSION_START=VSCODE 是最直白的方式，但前提是 xdebug.idekey 设的是 VSCODE。如果设成 PHPSTORM，这个参数就无效。更稳妥的做法：
- 浏览器装
Xdebug Helper插件，右键图标选 “Debug”，它会自动注入 CookieXDEBUG_SESSION=VSCODE - 临时在 PHP 代码里加
xdebug_break();，只要 Xdebug 在 debug 模式下就会立刻中断 - 确保 VSCode 底部状态栏显示 “Listening on port 9003” —— 如果没显示，说明插件没监听或端口被占
最后留个心眼：xdebug.log=/tmp/xdebug.log 和 xdebug.log_level=7 加进 php.ini，日志里会明确写出连接拒绝、路径未映射、IDE key 不匹配等具体原因，比猜快得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
