必须关闭xdebug.use_compression=false，否则Xdebug默认压缩profile文件为gzip格式，而QCacheGrind和部分PhpStorm版本不支持解压，导致文件无法识别或显示空白。
xdebug.use_compression=false 是必须关的，否则 QCacheGrind 打不开 profile 文件
为什么 profile 文件打不开？
你生成了 cachegrind.out.* 文件，但用 QCacheGrind 或 PhpStorm 打开时提示“无法识别格式”或直接空白——大概率是文件被压缩了。Xdebug 3 默认开启 xdebug.use_compression=1，生成的文件实际是 gzip 压缩过的，后缀虽仍是 .out，但内容不是纯文本 cachegrind 格式。
QCacheGrind 不支持解压，PhpStorm 某些版本也只读原始格式；强行拖入会静默失败，没有任何报错提示。
xdebug.use_compression 配置位置和值
这个选项只在启用 profiler（性能分析）时生效，且必须写在 php.ini 或 conf.d/xdebug.ini 中，不能运行时用 ini_set() 修改。
-
xdebug.use_compression=0或xdebug.use_compression=off都可以，推荐用0 - 必须搭配
xdebug.mode=profile（Xdebug 3）或已启用 profiler 的旧配置才起作用 - 改完记得重启 PHP 进程（
php-fpm reload或重启 Apache/Nginx）
验证是否生效的最快方法
生成一个 profile 文件后，用终端快速检查：
Xdebug 3.4.1 是一款功能强大的 PHP 调试扩展工具，于 2025 年 1 月 6 日正式发布。作为 Xdebug 3.4 系列的首个修复版本，3.4.1 版在继承上一版本强大功能的同时，重点解决了稳定性问题。该版本不仅修复了访问超全局变量时可能引发的程序崩溃现象，还增强了对 Windows 平台 PIE 构建机制的支持，为广大 PHP 开发者提供了更加稳定的调试环境。这一版本适合所有
file /var/tmp/xdebug/cachegrind.out.*
如果输出含 gzip compressed data，说明还在压缩；如果显示 ASCII text 或 PHP script，说明已关闭成功。
也可以用 head -n 5 /path/to/cachegrind.out.* 看前几行：正常 cachegrind 文件开头是 fl=、fn=、1 这类字段；压缩文件开头是乱码或 \x1f\x8b 字节。
顺手要配的关联项
单关 xdebug.use_compression 不够，常见连带问题一起处理：
-
xdebug.output_dir目录要有写权限（比如chmod 777 /var/tmp/xdebug），否则文件根本写不进去 -
xdebug.start_with_request=trigger（推荐）而不是，避免每次请求都尝试连 IDE 导致延迟</li> <li>访问 URL 时带上 <code>?XDEBUG_PROFILE=1
触发生成，别依赖自动开启 - 如果用 Docker，
xdebug.output_dir最好映射到宿主机可读路径，比如/www/project/xdebug，不然容器里生成了你也拿不到
压缩开关看着小，但它卡在“生成→保存→读取”链路最末端，一旦没关，前面所有配置都白搭——文件存在，但等于没生成。
