Xdebug 不支持在取余符号 % 处直接设断点，但可在含 % 的整行代码设普通断点或条件断点（如 $i % 7 === 0），或拆分表达式提升可调试性。
Xdebug 本身不直接支持“只在取余表达式（如 $a % $b）处断点”，它没有语法级的断点类型。但你可以通过几种实用方式精准定位并调试取余运算，关键在于理解 PHP 执行流程和 Xdebug 的断点机制。
在取余所在的行下普通行断点
最直接有效的方式：找到包含 % 运算符的那行代码（比如 $result = $x % $y; 或 if ($n % 2 === 0)），在该行左侧点击设置断点。Xdebug 会在执行到该行**开始执行前**暂停，此时你可以查看所有变量值、单步步入（Step Into）看是否进入函数内部，或单步跳过（Step Over）。
- 确保该行确实会执行（比如不在被跳过的 if 分支里）
- 如果取余写在复杂表达式中（如
func($a % $b, $c)），断点仍设在这整行，Xdebug 会在调用 func 前暂停，此时$a % $b尚未计算 —— 你可在 Watch 窗口手动输入$a % $b预览结果
用条件断点缩小触发范围
如果你要调试的是循环中某次特定的取余（比如只关心 $i % 7 === 0 的那次），可以右键断点 → 设置条件（Condition）。例如填入：$i % 7 === 0
这样只有满足条件时才会中断，避免反复按 F5。
- 条件表达式需是合法 PHP 表达式，且作用域内变量必须已定义
- Xdebug 3+ 支持完整表达式，包括函数调用（如
is_int($x) && $x % 5 === 0）
配合日志 + 断点快速定位隐式取余
有些取余藏在函数内部（如 date('w') 内部用取余算星期，或自定义分页逻辑 $offset = ($page - 1) * $limit 后再取余校验）。这时可：
Xdebug 3.4.1 是一款功能强大的 PHP 调试扩展工具，于 2025 年 1 月 6 日正式发布。作为 Xdebug 3.4 系列的首个修复版本，3.4.1 版在继承上一版本强大功能的同时，重点解决了稳定性问题。该版本不仅修复了访问超全局变量时可能引发的程序崩溃现象，还增强了对 Windows 平台 PIE 构建机制的支持，为广大 PHP 开发者提供了更加稳定的调试环境。这一版本适合所有
- 先在疑似位置加
error_log("DEBUG: about to %, a=$a, b=$b"); - 查日志确认哪次调用触发了问题，再去对应代码行下断点
- 或直接在函数入口设断点，然后用 Step Into 跟进，观察栈帧中哪一层执行了
%
注意：别在表达式中间“下断点”
Xdebug 不允许你在 $a % $b 中的 % 符号上单独设断点，也不支持类似 gdb 的“指令级断点”。所谓“跟踪取余表达式”，本质是跟踪**执行该运算的那条语句**。如果一行有多个取余（如 $x % 2 + $y % 3），它们在同一行执行，无法单独中断其中一个；此时建议拆成两行，或用临时变量提升可调试性：
// 原写法（难区分）<br>$sum = $x % 2 + $y % 3;<br>// 推荐改写<br>$mod_x = $x % 2;<br>$mod_y = $y % 3;<br>$sum = $mod_x + $mod_y;
