xdebug profiling需手动触发且依赖正确配置：xdebug 3必须设xdebug.mode=profile、output_dir可写、start_with_request=trigger，再通过url加?xdebug_profile=1或cli设xdebug_trigger=1触发，生成cachegrind.out.*文件后用kcachegrind分析。
直接开启 Xdebug profiling 不会自动出数据，必须配合触发机制和可写的输出目录，否则 cachegrind.out.* 文件根本不会生成。
确认 Xdebug 已安装且支持 profiling
先验证扩展是否加载、版本是否支持 profiling 功能：
- 运行
php -m | grep xdebug，有输出才算加载成功 - 运行
php --ri xdebug，检查输出中是否含profiler字样（Xdebug 3+ 要求xdebug.mode包含profile） - 若用的是 Xdebug 2，
xdebug.profiler_enable=1才有效；Xdebug 3 必须设xdebug.mode=profile，设成debug,profile也行
配置 php.ini 中的 profiling 关键项
Xdebug 3 的配置逻辑变了，错配会导致 profiling 完全静默：
-
xdebug.mode=profile—— 必须显式启用，仅develop或debug不够 -
xdebug.output_dir=/tmp/xdebug—— 目录必须存在且 PHP 进程有写权限（chown www-data:www-data /tmp/xdebug） -
xdebug.profiler_output_name=cachegrind.out.%p——%p是进程 PID，避免并发覆盖 -
xdebug.start_with_request=trigger—— 推荐设为trigger，用XDEBUG_PROFILE参数按需开启，避免全量采样拖慢服务
别碰 xdebug.profiler_enable=1 这种 Xdebug 2 风格配置，Xdebug 3 下它会被忽略。
触发 profiling 并验证文件生成
不触发就不会写文件，光配对没用：
- Web 请求：在 URL 后加
?XDEBUG_PROFILE=1，例如http://localhost/app.php?XDEBUG_PROFILE=1 - CLI 脚本：执行前加环境变量
XDEBUG_TRIGGER=1 php script.php - 检查
/tmp/xdebug/是否出现cachegrind.out.*文件（注意不是profile.*） - 若无文件，先
ls -l /tmp/xdebug看权限，再tail -f /var/log/php-fpm/www-error.log查 Xdebug 报错
用 KCachegrind 分析 cachegrind 文件
生成的文件是二进制格式，不能直接 cat，得用专用工具看：
- Linux 下装
kcachegrind：sudo apt install kcachegrind（Ubuntu/Debian） - 打开文件：
kcachegrind /tmp/xdebug/cachegrind.out.12345 - 重点关注
Self Time列——值高说明函数自身耗时长，比如Fqsen::__construct占 28.7% 就该优化正则 - 右键调用树里的函数 → “Jump to source” 可定位到具体代码行（需 PHP 源码路径匹配）
profiling 开销不小，单次请求可能增加 3–10 倍执行时间，切勿在生产环境长期开启，也别用 start_with_request=yes 全局启用。
