<p>Xdebug Profiler 在 PhpStorm 中不会自动生效，必须同时满足四个条件：正确配置 PHP（xdebug.mode=profile 且 xdebug.start_with_request=trigger）、通过 ?XDEBUG_PROFILE=1 或 Cookie 触发、xdebug.output_dir 目录对 Web 进程（如 www-data）可写、生成的 cachegrind.out.* 文件须通过 PhpStorm 的 Tools → Analyze Xdebug Profiler Snapshot 专用入口打开。</p>
Xdebug Profiler 在 PhpStorm 里不会自动生效，必须同时满足四个条件：PHP 配置正确、触发方式匹配、输出目录可写、文件要用专用入口打开。
确认 PHP 实际加载的 php.ini 是哪个
很多人改了错误的配置文件，导致 xdebug.mode=profile 像没写一样。PhpStorm 的 CLI 和 Web 请求用的不是同一份配置：
- 在 PhpStorm 中按
Ctrl+Alt+S→PHP→ 点击CLI Interpreter右侧的 ⚙️ 图标 → 查看 “Configuration file” 路径，这才是你要编辑的php.ini - Web 请求（比如浏览器访问）走的是 PHP-FPM 或 Apache 模块，需单独检查：在项目里建一个
info.php，内容为<?php phpinfo(); ?>，搜索 “Loaded Configuration File”，路径可能和 CLI 完全不同 - 两个环境都得配，否则只在命令行能 profile，浏览器访问不生成文件
Xdebug 3 必须设对两个开关才触发 Web 请求 profiling
xdebug.mode=profile 单独设了没用，它只是声明“我支持 profiling”，真正决定是否执行的是 xdebug.start_with_request：
- 设成
trigger：只在带?XDEBUG_PROFILE=1或 CookieXDEBUG_PROFILE=1时启动 —— 推荐，避免污染生产流量 - 设成
yes：每次请求都 profile —— 仅限本地快速验证，千万别在共享环境开 - 别混用旧参数：
xdebug.profiler_enable或xdebug.profiler_enable_trigger是 Xdebug 2 的写法，在 Xdebug 3 下会被忽略
生成的 cachegrind.out.* 文件不能双击打开
直接双击或拖进 PhpStorm 会报错/乱码，因为 PhpStorm 不识别原始格式。必须走专用入口：
立即学习“PHP免费学习笔记（深入）”；
- 菜单栏选
Tools→Analyze Xdebug Profiler Snapshot - 手动定位到
cachegrind.out.*文件（比如/tmp/xdebug/cachegrind.out.12345） - 打开后默认是
Flat View，只看总耗时；切到Call Tree才能看到完整调用链，比如Controller::index()→Service::fetchData()→PDO::query() - 重点对比
Inclusive Time（含子调用）和Exclusive Time（纯自己代码）：如果前者高、后者低，说明瓶颈在下游（比如没索引的 SQL），不是函数本身慢
Profiler 看不到数据库或 HTTP 请求真实耗时
Xdebug Profiler 只记录 PHP 函数执行时间，PDO::query() 显示的耗时是 PHP 层面的调用开销，不是 MySQL 真实执行时间；同理，file_get_contents() 或 cURL 的时间也不含网络往返延迟。
这意味着：
- 你看到
PDO::query()耗时 80ms，不代表 SQL 执行了 80ms，可能是连接池等待 + 网络传输 + MySQL 自身执行的总和 - 想定位真实 DB 耗时，得配合 MySQL 的 slow log 或
EXPLAIN；HTTP 请求得靠curl_getinfo()或专门的 APM 工具（如 Blackfire） - Profiler 的价值在于发现“谁调用了太多次慢函数”，比如一个循环里反复查缓存，
redis->get()单次快，但被调 500 次，Calls列一目了然
最容易被忽略的是权限和触发方式的组合：哪怕 xdebug.output_dir="/tmp/xdebug" 存在，如果 Web Server 进程（如 www-data）没有写入权限，文件就根本不会落地 —— 先 ls -ld /tmp/xdebug，再 sudo chown www-data:www-data /tmp/xdebug，比 chmod 777 更安全也更有效。
