DebugBar 4.x可为ThinkPHP 7.1提供可视化调试，需手动适配：安装^4.9版本、注册中间件于最后、配置debugbar.php启用收集器，并在布局模板中插入{debugbar_render()}。
想在ThinkPHP 7.1项目里实时查看SQL执行、请求耗时、变量状态，又不想手写日志或打断点逐行跟踪——DebugBar就是为此设计的可视化调试工具，它能直接嵌入页面底部显示结构化调试信息。
确认ThinkPHP 7.1环境兼容性
DebugBar官方未原生支持ThinkPHP 7.1，需手动适配。TP7.1基于Swoole协程与PSR-15中间件架构，【必须使用DebugBar 4.x版本，3.x及以下不兼容协程上下文】。执行命令前先检查PHP版本：php -v 应显示8.1或更高版本。
运行 composer show debugbar/debugbar 查看已安装版本，若低于4.9.0，请先卸载：composer remove debugbar/debugbar。
安装DebugBar并注册中间件
执行 composer require debugbar/debugbar:^4.9 ——注意末尾的^符号不能省略，否则可能装错分支。
立即学习“PHP免费学习笔记（深入）”；
在app/middleware.php中添加中间件注册：
return [
// 其他中间件…
think\middleware\DebugBar::class,
];
【此行必须放在所有业务中间件之后、响应发送之前，否则DebugBar数据无法注入HTML】。若你用的是自定义中间件链，请确保DebugBar位于最后执行。
配置DebugBar启用条件
编辑config/debugbar.php（若不存在则新建），填入以下内容：
return [
'enabled' => app()->isDebug(),
'storage' => ['driver' => 'file', 'path' => runtime_path('debugbar')],
'options' => ['capture_ajax' => true, 'collectors' => ['phpinfo', 'messages', 'time', 'database', 'views']],
];
其中'database'收集器依赖PDO连接，若项目使用了多数据库连接，请确认默认连接名为'db'；否则需在collectors中显式指定：'database' => ['connection' => 'mysql2']。
启用页面底部调试栏
第一步：打开public/index.php，在require __DIR__.'/../vendor/autoload.php';之后插入：
if (app()->isDebug()) {
DebugBar\StandardDebugBar::init();
}
第二步：在app/view/layout.html（或你实际使用的公共布局模板）的</body>标签前加入：
{if app()->isDebug()}
{debugbar_render()}
{/if}
第三步：清空runtime/cache目录，重启Swoole服务（php think start）。
此时访问任意页面，右下角应出现可折叠的蓝色调试面板。点击“SQL”标签页可查看本次请求所有执行语句及绑定参数；点击“Time”能看到各阶段耗时分布——包括路由解析、中间件执行、视图渲染等。
