断点打上不暂停，主因是xdebug.mode未设为debug、路径映射错位或端口不匹配；三者缺一，断点即失效——需确认xdebug.mode=debug已生效、phpstorm路径映射精准对应服务器文档根目录、且debug监听端口（默认9003）与xdebug.client_port严格一致。
断点打上了但不暂停？不是 PhpStorm 坏了，是它根本没“认出”该停——xdebug.mode=debug 没开、路径映射错位、端口对不上，三者缺一，断点就成摆设。
确认 Xdebug 已进入 debug 模式而非仅加载
很多用户看到 phpinfo() 里有 Xdebug 就以为万事大吉，其实只是扩展加载了，没启用调试通道。Xdebug 3.x 后 xdebug.remote_enable=1 已废弃，留着反而干扰；必须显式设置：
-
xdebug.mode=debug（PHP 8.0+ 必须）或xdebug.mode=develop,debug（兼顾 var_dump 高亮） -
xdebug.start_with_request=yes—— 避免手动拼?XDEBUG_SESSION_START=1，尤其对 AJAX 或 CLI 调试场景更可靠 - 重启 PHP 服务后，访问
phpinfo()页面，搜索xdebug.mode，值必须为debug；再搜xdebug.status，应显示enabled
校准 PhpStorm 的路径映射（关键！90% 断点不命中源于此）
PhpStorm 知道断点在哪行，但不知道这行代码对应服务器上哪个文件。如果本地路径 /home/user/project 没映射到 Web 服务器的 /var/www/html，它就找不到源码，自然不暂停。
- 进 Settings → Languages & Frameworks → PHP → Servers，添加或编辑你的服务器（如
localhost） - 务必勾选
Use path mappings - 在映射表中填：左侧填你 PhpStorm 里打开的项目根路径（绝对路径），右侧填 Web 服务器实际执行 PHP 的文档根目录（例如 Nginx 的
root或 Apache 的DocumentRoot） - 路径末尾不要加斜杠；大小写需一致（Linux/macOS 敏感）；Windows 下用正斜杠
/或双反斜杠\，别用单反斜杠
区分“监听”和“运行”，别点错按钮
绿色虫子图标（Debug）≠ 启动调试监听。它只对当前 Run Configuration 生效，且默认不开启外部连接。真正让 PhpStorm “竖起耳朵”的操作是：
- 菜单栏 Run →
Start Listening for PHP Debug Connections（或快捷键Ctrl+Alt+Shift+L），右下角出现Debug listening…才算生效 - 确保 Settings → PHP → Debug 中：
Debug port是9003（Xdebug 3 默认），且勾选Can accept external connections - 浏览器访问 URL 或 Postman 发请求时，必须触发 Xdebug 连接（靠
xdebug.start_with_request=yes或手动加参数），而不是靠点击绿色虫子启动脚本
条件断点与日志断点的实用边界
条件断点不是万能开关，它在每次命中断点时都求值表达式，若条件含复杂逻辑或 I/O，会显著拖慢执行；日志断点不暂停，但输出内容依赖 IDE 日志面板是否打开。
- 设条件断点：右键行号旁红点 →
Add condition breakpoint，填纯布尔表达式，例如$user->id === 123或!empty($data)；避免调用函数或查询数据库 - 日志断点适合埋点观察：右键 →
Add log point，输入log: user id = { $user->id }，变量名必须用{}包裹，且仅限当前作用域可见变量 - 注意：条件/日志断点在 CLI 脚本中可能不生效，因部分 CLI SAPI 不支持完整 DBGp 协议
最常被忽略的一点：Xdebug 3.x 默认不跟踪 vendor 和系统扩展，但如果你在 composer install 后改过包内代码，又没关 Ignore external libraries（Settings → PHP → Debug → Stepping），断点可能卡在你不关心的第三方代码里，误判为“跳进去了出不来”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
