xdebug适合开发环境单请求深度采样，blackfire更适合fpm/cli下低干扰、可复现的性能快照；需正确配置xdebug.mode=profile、手动启停分析、避开opcache干扰，并优先定位问题域再采样。
Xdebug 和 Blackfire 不是二选一，而是分阶段用：Xdebug 适合开发环境单请求深度采样，Blackfire 更适合 FPM/CLI 场景下低干扰、可复现的性能快照。
怎么让 Xdebug 真正生成 cachegrind 文件
ThinkPHP 入口文件（如 public/index.php）默认不会触发 profiling，xdebug.profiler_enable=1 在 FPM 模式下常被忽略，且 xdebug.profiler_enable_trigger 容易被路由中间件拦截。
- 在
php.ini中设xdebug.mode=profile（Xdebug 3+），不是debug,profile混用——develop模式会覆盖profile - 加
xdebug.profiler_output_dir="/tmp/xdebug"，确保 PHP 进程对该目录有写权限，路径不含空格或中文 - 在
public/index.php开头调用xdebug_start_profiling()，结尾调用xdebug_stop_profiling()，避免全站开启拖慢响应 - 禁用
opcache.enable=0，否则 ThinkPHP 核心类（如think\Container）可能被跳过采样
为什么 cachegrind 里看不到 Db::table()->select() 调用
不是没执行，是 Xdebug 默认只记录“进入用户代码”的调用栈；ThinkPHP 的数据库封装若用了反射加速（6.1+）、或方法被 opcache 内联优化，就会导致调用链变短甚至消失。
- 用
php --ri xdebug确认当前生效的xdebug.mode，检查是否被.user.ini或 FPM pool 配置覆盖 - 临时改用
debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS)在关键位置打点，验证方法是否真被调用 - 若需完整链路，可配合
xdebug.collect_params=4+xdebug.collect_return=1，但会显著增大文件体积
Blackfire 采集失败常见原因
Blackfire 启动后无数据，或报 Connection refused / Invalid signature，多数和环境配置或启动时机有关。
- 确认
extension=blackfire.so已加载，且blackfire.agent_socket指向正确的 socket 路径（如unix:///var/run/blackfire/agent.sock） - 不要在 ThinkPHP 中间件或 Hook 里调用
blackfire_enable()—— 应放在public/index.php最顶部，在任何框架初始化之前 - CLI 下用
blackfire run php index.php，FPM 下需通过请求头X-Blackfire-Query触发，别依赖 URL 参数（如?blackfire=1） - 禁止同时启用 Xdebug 和 Blackfire：二者共存会导致 PHP 进程卡死或采样中断
真正难的不是工具怎么装，而是判断“该在哪一层采样”：数据库慢？模板渲染卡？还是容器解析耗时？先用 microtime(true) 在入口、Db 调用前后、View 渲染前后打三处点，5 分钟就能圈定问题域。Xdebug 和 Blackfire 是放大镜，不是探照灯——得先知道往哪照。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
