ThinkPHP 5.1 中 trace.php 用于自定义 Trace 面板内容，需在 APP_DEBUG=true、app_trace=true、show_page_trace=true 且清空 runtime 后，置于 application/extra/ 目录下生效。
ThinkPHP 5.1 中的 trace.php 是用于**自定义 Trace 面板内容**的配置文件，它本身不“开启”调试模式，而是配合已启用的调试环境（即 APP_DEBUG=true）来扩展右下角 Trace 面板显示的信息。要让 trace.php 生效，必须先确保整个 Trace 调试功能已正确启动。
一、确认基础调试已开启
Trace 面板依赖于全局调试开关，trace.php 只是锦上添花：
- 在入口文件
public/index.php顶部（<?php后、任何require前）添加：define('APP_DEBUG', true); - 清空
runtime/目录全部内容（含子目录和隐藏文件），否则旧缓存会屏蔽新配置 - 确保
config/app.php中'app_trace' => true已设置（TP5.1 中该配置项有效且必要）
二、创建并配置 trace.php 文件
该文件需放在 application/extra/ 目录下（不是 conf/ 或 config/），这是 TP5.1 的标准扩展配置路径：
- 新建文件：
application/extra/trace.php - 内容格式为返回一个关联数组，键为 Tab 标签名，值为你想显示的内容（支持字符串、数组、变量）：
<?php<br>return [<br> '用户信息' => ['uid' => session('uid'), 'ip' => request()->ip()],<br> '请求参数' => input(),<br> '自定义时间' => date('Y-m-d H:i:s')<br>]; - 注意：键名将作为 Trace 面板中的选项卡名称，如“用户信息”“请求参数”
三、验证与补充设置
仅靠 trace.php 不足以让面板出现，还需检查配套项：
立即学习“PHP免费学习笔记（深入）”；
- 确保
config/app.php中'show_page_trace' => true（TP5.1 默认关闭，必须显式开启） - 若页面无 HTML 输出（如 API 接口返回 JSON），Trace 面板不会渲染——这是正常行为，
trace.php仅作用于模板响应 - 可在控制器中用
trace($data, '标签名')动态追加数据到“调试”Tab，无需修改trace.php
四、常见失效原因
如果配置完仍看不到自定义 Tab：
-
application/extra/trace.php路径写错（不能放在conf/或根目录） - 文件编码不是 UTF-8 无 BOM（尤其 Windows 记事本易带 BOM）
- 未清空
runtime/，导致框架仍读取旧缓存配置 -
app_debug或app_trace在config/app.php中被设为false，且入口文件未覆盖
