行断点须设在可执行语句（如if、return、赋值等），不可设于空行、注释或class/function关键字行；通过gutter单击或Ctrl+F8/Cmd+F8设置，红点为空心说明该行不可执行或文件类型错误。
在 PhpStorm 中设置行断点的正确位置
行断点必须打在可执行语句上，不是任意一行都能停。比如 if、for、return、函数调用、赋值语句这些可以；但空行、纯注释行、class 或 function 关键字所在行（不带花括号）本身不可执行，点了也不会生效。
操作方式就两种：
– 在编辑器左侧灰色装订区域（gutter）单击，出现实心红点即成功；
– 光标置于目标行任意位置，按 Ctrl+F8（Windows/Linux）或 Cmd+F8（macOS）。
- 如果点完没反应，先检查是否在 PHP 文件里——非 PHP 文件（如 .txt、.json）不支持 PHP 断点
- 红点是空心的？说明该行不可执行，或者文件未被识别为 PHP（右下角查看文件类型，必要时右键 →
Override File Type→PHP） - 断点打在闭包或匿名函数内部时，需确保整个表达式已解析完成（比如
array_map回调里设断点，得等实际执行到那一步才触发）
为什么打了断点却从不停下来
最常见原因是 Xdebug 没连上 PhpStorm，或者断点根本没被加载进调试上下文。这不是断点本身的问题，而是环境链断了。
-
xdebug.mode=debug必须显式设置，xdebug.remote_enable=1在 Xdebug 3+ 已废弃，留着反而导致静默失败 -
xdebug.client_host推荐写死为127.0.0.1，别用localhost（某些系统 DNS 解析卡住，Xdebug 直接放弃连接） - PhpStorm 的监听没开：必须手动点
Run → Start Listening for PHP Debug Connections，右下角出现Debug listening…才算生效；只点绿色虫子图标（Debug）不会自动开启监听 - 路径映射没配：Settings → Languages & Frameworks → PHP → Servers → 勾选
Use path mappings，把本地项目路径（如/home/user/project）映射到 Web 服务器看到的路径（如/var/www/html），否则 Xdebug 告诉 IDE “停在 /var/www/html/index.php 第15行”，IDE 却找不到对应文件
给包裹代码加条件断点的实用技巧
循环体、回调函数、高频调用方法里直接打普通断点等于自虐。用条件断点能精准控制触发时机。
立即学习“PHP免费学习笔记（深入）”；
右键 gutter 上已有断点 → Add Condition，输入表达式即可。例如：
count($items) > 100
$user->id === 123
注意：
- 条件里只能写 PHP 表达式，不能写语句（比如不能写
echo 'hit'; return true;） - 变量必须在当前作用域可见；闭包内访问外部变量需确认是否 use 传递
- 条件表达式本身有性能开销，高频代码中慎用复杂计算，优先用简单比较（
===比==更快且安全） - 想记录而不中断？右键选
Add Log Point，填入Hit: $i, count: {count($arr)}，输出会出现在Console标签页
异常断点比包裹代码更省事
与其在 try-catch 外围或每个可疑函数里挨个设断点，不如用异常断点一网打尽。
快捷键 Ctrl+Shift+F8 → 点 + → PHP Exception Breakpoint → 输入 Exception 或具体类名如 TypeError。只要抛出，立刻中断，连堆栈都给你展开好了。
- 勾选
Include subclasses，否则InvalidArgumentException这类子类不会被捕获 - 不想在框架底层异常上浪费时间？右键断点 →
More...→ 勾选Ignore library files - 它不依赖源码位置，也不吃路径映射，只要 Xdebug 连着，哪怕错误发生在 vendor 里也能停
真正难的从来不是“怎么打点”，而是确认 Xdebug 正在说话、PhpStorm 正在听、而你的代码恰好走在被监听的路径上。少一个环节，红点就是摆设。
