Yii2 Debug工具栏需同时满足YII_DEBUG=true、IP在allowedIPs白名单、YII_ENV=dev三条件才显示；SQL面板需enableLogging开启且操作走Yii::$app->db；Profiling依赖Xdebug或Tideways扩展。
Yii2 Debug 工具栏不是装上就“自动好用”的，真正提效的关键，在于理解它怎么加载、数据从哪来、哪些操作能快速定位问题。下面这些技巧，覆盖高频卡点和实用捷径。
工具栏不显示？先查这三件事
90% 的“找不到工具栏”问题，都出在这三个硬性条件没同时满足：
-
YII_DEBUG 必须为 true：检查
web/index.php开头是否有defined('YII_DEBUG') || define('YII_DEBUG', true); -
IP 必须在 allowedIPs 白名单中：默认只认
127.0.0.1和::1；用 Docker、WSL 或局域网真机调试时，要加'192.168.*'或具体 IP -
必须运行在 YII_ENV=dev 环境下：不能只设
YII_DEBUG=true就完事，还要确认YII_ENV是dev（可在入口文件加var_dump(YII_ENV, YII_DEBUG);验证）
验证是否模块已启用：直接访问 /debug/default/index，能打开说明模块注册成功，问题出在工具栏渲染环节（比如页面是 renderAjax() 或纯 JSON 接口，就不会加载）。
SQL 面板查不到语句？重点看日志链路
DB 面板空白或只有“0 条查询”，往往不是配置错，而是 SQL 根本没进 Yii 的日志管道：
-
确保
enableLogging开启：在数据库组件配置里显式写'enableLogging' => true（有些项目为省开销手动关了） -
所有 DB 操作必须走
Yii::$app->db：绕过它直连 PDO、用$db->pdo执行，Debug 完全捕获不到 -
参数占位符不会自动替换：看到
WHERE id = :id是正常的；点开单条 SQL 后展开「Params」才能看到实际绑定的值 -
批量操作可能被合并：
batchInsert()或事务内多语句，有时只显示汇总条数；需配合runtime/debug/下的原始日志文件交叉核对
Profiling 面板时间不准或空？Xdebug 是门槛
Profiling 面板不是纯 PHP 能撑起来的，它依赖外部扩展提供函数级耗时数据：
- 必须安装并启用 Xdebug（3.0+）或 Tideways：仅靠 Yii 自身只能显示粗略节点（如 Application Init、Response Send）
-
Xdebug 配置要对：
xdebug.mode=profile（不是debug），且xdebug.start_with_request=trigger可选（避免全程开销） - 别在生产环境开：Xdebug 会让响应慢 3–5 倍，本地或测试机用完即关
- 没装扩展时别硬点 Profiling：面板会显示但无法展开调用树，属于正常行为，不是你配置错了
快速定位慢请求和错误源头
不用点开每个面板翻半天，这几个组合操作能秒级聚焦问题：
-
按耗时排序请求历史：在
/debug/default/index页面，点击「Time」列标题，把最慢的请求排到最前 -
用 Logs 面板过滤关键词：输入
error、exception、slow，再结合时间戳快速锁定报错时段 - DB 面板点「Explain」看执行计划：对慢 SQL 直接点右侧图标，判断是否命中索引、有没有全表扫描
- Request 面板里复制完整 URL：含所有 GET 参数，方便复现或写单元测试
不复杂但容易忽略。
