CodeIgniter调试工具栏默认仅在development环境启用,需满足APP_ENV=development、启用intl和mbstring扩展、且未被禁用;配置后需重启服务器,并确认Toolbar.php中$enabled=true及collectors非空。

CodeIgniter 调试工具栏(Debug Toolbar)默认只在开发环境启用,开启它需要同时满足三个条件:环境配置正确、扩展支持到位、且未被手动禁用。
确认并设置开发环境
调试工具栏依赖 APP_ENV 环境变量为 development。检查项目根目录下的 .env 文件:
- 确保存在且未被注释:
CI_ENVIRONMENT = development - 如果写成
production或testing,工具栏将完全不加载 - 修改后需重启 Web 服务器(如 Apache/Nginx)或刷新 PHP-FPM 缓存(若使用)
检查必需的 PHP 扩展是否启用
Debug Toolbar 依赖 intl 和 mbstring 扩展。在命令行运行:
php -m | grep -E "intl|mbstring"
- 若无输出,需在 php.ini 中取消对应扩展的注释(如
extension=intl、extension=mbstring) - Windows 下 Wamp/Xampp 用户可在系统托盘右键 → PHP → PHP Extensions 中勾选启用
- 保存后务必重启 Web 服务
验证配置与排除干扰
即使环境和扩展都正常,仍可能因配置被覆盖而失效:
- 打开 app/Config/Toolbar.php,确认
$collectors数组非空,且$enabled = true - 检查 app/Config/Boot/development.php 是否存在并被正确加载(该文件在 development 环境下自动引入)
- 若使用自定义中间件或重写了
BaseController的initController(),确保未意外调用$this->toolbar->disable()
访问页面并确认显示
在浏览器中打开任意已路由成功的页面(如 / 或 /home),页面右下角应出现半透明浮动面板。鼠标悬停可展开各数据区(Routes、Database、Views 等)。若仍不显示:
- 按 F12 打开开发者工具,查看 Console 是否报错(如 JS 加载失败)、Network 是否请求了
debugbar相关资源 - 临时在控制器中加一行:
echo \CodeIgniter\CodeIgniter::CI_VERSION;,确认框架确实运行且版本正确











