Laravel Debugbar 可快速查看请求、SQL、日志等调试信息，提升开发效率。1. 使用 composer require barryvdh/laravel-debugbar --dev 安装，仅限开发环境。2. Laravel 5.5+ 支持自动发现，无需手动注册服务提供者；如需则在 config/app.php 中添加 Barryvdh\Debugbar\ServiceProvider::class。3. 运行 php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider" 生成配置文件。4. 确保 .env 中 APP_DEBUG=true，生产环境必须设为 false。5. 页面底部将显示工具栏，包含路由、执行时间、数据库查询、日志、会话、Cookie 和视图数据；可通过 Debugbar::info()、error()、addMessage() 手动记录信息。6. 若异常，检查 PHP 与 Laravel 版本兼容性、清除配置缓存、确保 storage 目录可写，部分响应类型如 JSON 不显示工具栏。
想要在Laravel项目中快速查看请求、SQL查询、日志等调试信息，Laravel Debugbar 是一个非常实用的开发工具。它以浏览器底部工具栏的形式展示调试数据，极大提升开发效率。下面介绍如何安装与配置 Laravel Debugbar。
1. 安装 Laravel Debugbar 扩展包
使用 Composer 在项目根目录下执行以下命令安装：
composer require barryvdh/laravel-debugbar --dev
注意：建议仅在开发环境安装，因此加上 --dev 参数，避免上线时暴露敏感信息。
2. 配置服务提供者（Laravel 9 及以下可能需要）
Laravel 5.5+ 支持自动发现，通常无需手动注册。如果你关闭了自动发现或使用较老版本，需手动添加服务提供者。
打开 config/app.php，在 providers 数组中添加：
Barryvdh\Debugbar\ServiceProvider::class,
如需使用门面（可选），也可在 aliases 中添加：
'Debugbar' => Barryvdh\Debugbar\Facades\Debugbar::class,
3. 发布配置文件
运行以下命令生成配置文件：
php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider"
该命令会在 config/ 目录下创建 debugbar.php，可根据需要自定义启用面板、存储路径等选项。
4. 控制开启环境
默认情况下，Debugbar 仅在 APP_DEBUG=true 时显示。确保 .env 文件中有：
APP_DEBUG=true
生产环境中应设置为 false，防止调试信息泄露。
5. 使用示例与常见设置
安装完成后，刷新页面，浏览器底部会出现 Debugbar 工具栏。你可以看到：
- 路由信息
- 执行时间
- 数据库查询（含执行时间与绑定参数）
- 日志消息
- 会话与Cookie数据
- 视图加载情况
如需在代码中手动记录信息，可使用：
\Debugbar::info('测试信息');
\Debugbar::error('报错信息');
\Debugbar::addMessage('自定义消息', 'custom');
6. 常见问题处理
若页面空白或提示错误，检查以下几点：
- 确认 PHP 版本和 Laravel 版本兼容
- 清除配置缓存：
php artisan config:clear - 确保 storage 目录可写，用于存储 Debugbar 数据（如启用）
- 部分中间件或响应类型（如 JSON）可能不显示工具栏
基本上就这些。Laravel Debugbar 安装简单，功能强大，是开发阶段不可或缺的辅助工具。
