trace记录执行路径，profiling统计耗时分布；前者关注“代码怎么走”，含调用栈、参数、返回值；后者关注“哪段最慢”，提供调用次数、总耗时、独占耗时等聚合数据。
trace 是记录执行路径，profiling 是统计耗时分布
很多人以为 xdebug_start_trace() 和 xdebug_start_profiling() 只是“开关名字不同”，其实它们解决的是两类完全不同的问题：trace 关注「代码怎么走的」，profiling 关注「哪段最慢、占多少资源」。
典型表现差异：
-
trace文件里全是函数调用栈、参数值、返回值、进入/退出时间戳，适合查逻辑跳转错误、变量被谁改过、是否进了预期分支； -
profiling输出的是 flat profile（扁平统计）或 callgrind 格式，能看到每个函数的调用次数、总耗时、独占耗时、子函数耗时占比，适合定位性能瓶颈。
举个例子：一个页面加载慢，你用 trace 可能发现某处反复调用了 file_get_contents() 但没报错；而用 profiling 才能确认这 12 次调用总共占了 800ms —— 这才是优化依据。
xdebug.trace_enable_trigger 不等于 xdebug.profiler_enable_trigger
两个触发机制独立配置，不能混用。如果你只开了 xdebug.profiler_enable_trigger=1，但没配 xdebug.trace_enable_trigger，那加 ?XDEBUG_PROFILE=1 不会生成 trace 文件；反之亦然。
常见误配点：
Xdebug 3.4.1 是一款功能强大的 PHP 调试扩展工具，于 2025 年 1 月 6 日正式发布。作为 Xdebug 3.4 系列的首个修复版本，3.4.1 版在继承上一版本强大功能的同时，重点解决了稳定性问题。该版本不仅修复了访问超全局变量时可能引发的程序崩溃现象，还增强了对 Windows 平台 PIE 构建机制的支持，为广大 PHP 开发者提供了更加稳定的调试环境。这一版本适合所有
- 开发环境常想「按需开启 trace」，结果只设置了
xdebug.start_with_request=no却忘了配trace_enable_trigger，导致加参数也无响应； - 某些 Nginx + PHP-FPM 部署中，
_GET参数无法透传到 CLI 模式下运行的脚本，所以XDEBUG_TRACE触发在命令行无效，必须用xdebug_start_trace()手动调用； -
profiler_output_name默认是cachegrind.out.%p，而trace_output_name默认是trace.%c.%t，注意路径权限和磁盘空间——大流量下 trace 文件可能每秒几 MB，profiling 文件则更小但解析更重。
别把 profiling 当 trace 用，也别拿 trace 查性能
这是最容易踩的坑：用 trace 文件硬找“哪个函数慢”，效率极低。因为 trace 文件没有聚合统计，你得自己数时间差、算嵌套深度；反过来，用 profiling 查“变量值是多少”也不现实——它压根不记录参数和返回值。
选型建议直接看场景：
- 逻辑异常、流程跳转不对、第三方 SDK 行为不可控 → 用
trace，配合xdebug.collect_params=4和xdebug.collect_return=1； - 接口响应慢、内存增长快、CPU 持续 90%+ → 用
profiling，输出callgrind.out.%t.%p后用qcachegrind或flamegraph.pl分析； - 想同时兼顾？可以共存，但要分开开关：比如用
XDEBUG_TRACE=1开 trace，XDEBUG_PROFILE=1开 profiling，二者输出文件不冲突，但注意 I/O 压力翻倍。
PHP 8.2+ 的 profiling 替代方案值得留意
Xdebug 的 profiling 在高并发下开销明显，尤其 xdebug.mode=profile 全局启用时，单请求可能增加 3–5 倍 CPU 时间。PHP 8.2 起内置了 phpdbg 的轻量 profiling 支持，还有 ext/psr 提议中的标准性能事件接口，虽然目前生态工具少，但已可实验性使用 php -d zend_extension=phpdbg.so -dzend.assertions=0 -dxdebug.mode=off --profile script.php 测试基础耗时。
真正复杂的地方在于：trace 和 profiling 的输出格式、生命周期、清理策略完全不同。比如 trace 文件默认不压缩、不轮转，而 profiling 输出的 cachegrind 文件虽小，但 qcachegrind 加载百 MB 级文件会卡顿。这些细节不提前规划，上线后容易突然填满 /tmp 或拖垮 IDE 分析体验。
