xdebug.mode=profile 是启用性能分析的必要条件，但必须同时配置 xdebug.start_with_request=trigger、xdebug.output_dir 写权限及 ?XDEBUG_PROFILE=1 触发参数，否则无法生成 cachegrind.out.* 文件；PhpStorm 的“Profile”按钮仅作用于 CLI 环境，需手动在 Run Configuration 中添加 -dxdebug.mode=profile 等参数并确保 CLI 与 Web 共用同一 php.ini。
xdebug.mode=profile 是启用性能分析的必要条件，但仅设这一项无法生成有效报告——必须配合输出路径、触发方式和文件命名规则，否则 cachegrind.out.* 文件根本不会落地。
为什么 PhpStorm 里点“Profile”没反应？
PhpStorm 的“Profile”按钮默认依赖 CLI 环境下的 Xdebug 配置，而非 Web 请求上下文。它不读取 xdebug.start_with_request 或 Cookie 触发逻辑，而是直接调用 PHP 命令行并注入参数。
- 确保 CLI 使用的 php.ini 和 Web 使用的是同一份（可用
php --ini和phpinfo()对比） - 在 PhpStorm 的 Run Configuration → PHP Script 中，手动添加以下参数：
-dxdebug.mode=profile -dxdebug.output_dir=/tmp/xdebug -dxdebug.profiler_output_name=cachegrind.out.%p - 目录
/tmp/xdebug必须存在且 PHP 进程有写权限；Windows 用户注意路径分隔符和盘符可写性 - 若用 Docker，需挂载该目录到容器内，且宿主机与容器时间同步（否则文件名里的
%t可能出错）
Web 请求触发 profile 失败的三个常见原因
浏览器加 XDEBUG_TRIGGER=1 却没生成文件，大概率卡在这几个环节：
-
xdebug.start_with_request值不是trigger（Xdebug 3）或xdebug.profiler_enable_trigger未开启（Xdebug 2） - 请求中未携带有效触发标识：GET/POST 参数优先级低于 Cookie，但 Cookie 名必须是
XDEBUG_TRIGGER（大小写敏感），值需匹配xdebug.trigger_value（若设置了） - PHP-FPM 模式下，
xdebug.output_dir若指向/tmp，可能被系统清理或权限限制；建议改用项目内子目录如./runtime/profile并确保www-data或对应用户可写
生成的 cachegrind 文件打不开？别急着换工具
KCacheGrind / QCacheGrind 打开空白或报错，往往不是文件损坏，而是格式或路径问题：
- 确认文件开头是
events: Time SelfTime或类似 Cachegrind 标识行；若开头是乱码或 HTML，说明 Xdebug 实际没生效，日志被输出到了响应体中 - 检查
xdebug.mode是否混用了其他模式（如debug,profile），某些旧版 Xdebug 在 debug 模式下会干扰 profiler 输出 - 文件名必须以
cachegrind.out.开头（Xdebug 强制校验），自定义xdebug.profiler_output_name时不能漏掉这个前缀 - Mac 用户用 QCacheGrind 打不开？尝试终端执行：
open -a QCacheGrind /path/to/cachegrind.out.12345
