xdebug.mode=profile是唯一有效启用性能分析的方式，因其互斥设计，debug与profile不可混用；需单独设置并确保output_dir权限正确、避免/tmp路径、控制文件体积并正确配置phpstorm路径映射。
xdebug.mode=profile 是唯一有效的启用方式，其他 mode（如 debug、develop）不会触发性能分析。
为什么 xdebug.mode=profile 不能和 debug 混用
Xdebug 3.1 强制要求单一 mode 主导行为：xdebug.mode 是互斥开关，设为 debug,profile 会被忽略，实际只生效第一个值（通常是 debug），profile 完全不启动。这不是 bug，是设计约束。
- 必须显式写成
xdebug.mode=profile（仅此一项） - 若需调试+分析并存，得靠外部触发：保留
xdebug.mode=profile，再加xdebug.start_with_request=trigger，通过XDEBUG_PROFILECookie 或 GET 参数按需开启 - CLI 场景下可临时覆盖：
php -dxdebug.mode=profile -dxdebug.output_dir=/tmp/profiles script.php
output_dir 权限错误导致静默失败
生成的 cachegrind.out.* 文件写入失败时，Xdebug 不报错、不记录日志，直接跳过——这是最常被忽略的“没生成文件”原因。
Xdebug 3.4.1
下载
Xdebug 3.4.1 是一款功能强大的 PHP 调试扩展工具，于 2025 年 1 月 6 日正式发布。作为 Xdebug 3.4 系列的首个修复版本，3.4.1 版在继承上一版本强大功能的同时，重点解决了稳定性问题。该版本不仅修复了访问超全局变量时可能引发的程序崩溃现象，还增强了对 Windows 平台 PIE 构建机制的支持，为广大 PHP 开发者提供了更加稳定的调试环境。这一版本适合所有
- 确认
xdebug.output_dir目录存在且 PHP 进程有写权限（ls -ld /var/tmp/xdebug-profile+ps aux | grep php查用户） - Docker 环境中注意挂载路径与 SELinux/AppArmor 限制，建议用绝对路径并提前
mkdir -p /var/tmp/xdebug-profile && chmod 777 /var/tmp/xdebug-profile - 避免用
/tmp：某些系统对/tmp启用 noexec 或 tmpfs 内存盘，写入大 profile 文件会失败或耗尽内存
cachegrind 文件体积失控的三个临界点
一个 2 秒 HTTP 请求在 Xdebug 3.1 下可能生成 80MB+ 的 cachegrind.out.*，不是夸张——它记录每个函数调用栈、参数、返回值快照。
- 高频请求下，
xdebug.profiler_output_name=cachegrind.out.%t.%p（含时间戳）比默认%p（仅 PID）更利于识别和清理 - 别等磁盘报警才处理：加 cron 清理
find /var/tmp/xdebug-profile -name "cachegrind.out.*" -mmin +60 -delete - 单个文件超 50MB 时，
qcachegrind加载卡顿，改用webgrind（PHP 实现，支持分页加载）或 PhpStorm 内置 Profiler（内存映射解析，响应更快）
PhpStorm 中打开 profile 文件不显示调用树？
不是文件损坏，大概率是 PhpStorm 没识别到 Xdebug 版本或路径映射错位。
- 检查
Help → Diagnostic Tools → Debug Log Settings，开启XDebug日志，看是否报Unsupported profiler format - 确保
PHP → Servers配置中，本地路径与远程（或 CLI）路径完全一致，否则函数路径无法对齐，调用树为空 - PhpStorm 2025.1+ 支持直接拖入
cachegrind.out.*文件，但必须关闭 “Enable Xdebug proxy” 选项（该代理只用于 debug，不兼容 profile 流）
