ThinkPHP 8.0 的 Trace 调试面板需同时启用 APP_DEBUG=true 和 APP_TRACE=true（均写于 .env，无空格），并清空 runtime/、确保 UTF-8 无 BOM 编码及目录写权限；仅在 HTML 响应中显示，且 SQL 标签页依赖 log.php 中 'sql' 日志级别配置。
ThinkPHP 8.0 的性能追踪主要通过 **Trace 调试面板**实现，但它不是单纯的“开启开关”，而是一套需严格配置、协同生效的调试机制。核心目标是观察请求生命周期、SQL 执行、模板渲染、缓存读写等关键耗时环节——但前提是环境、配置、缓存、响应类型全部就位。
必须同时启用两个开关
Trace 面板依赖 APP_DEBUG 和 APP_TRACE 同时为 true，缺一不可：
-
APP_DEBUG=true是前提：决定是否进入调试上下文，影响异常页面、日志级别、模板编译行为 -
APP_TRACE=true是显式触发：告诉框架在 HTML 响应中注入 Trace 渲染逻辑 - 二者都必须写在
.env文件中，且等号两侧不能有空格，例如：APP_DEBUG=true（✘APP_DEBUG = true） - 如果
public/index.php中还残留define('APP_DEBUG', true)，会干扰环境变量加载，导致 APP_TRACE 失效
清空缓存并检查文件编码
TP8 将配置和容器信息固化在 runtime/ 目录下，改了 .env 不清缓存=白改：
- 手动删除整个
runtime/目录（不要只删子目录） - 确保
.env文件是 UTF-8 无 BOM 编码（VS Code 或 Notepad++ 另存时勾选“UTF-8 无 BOM”） - 确认 Web 服务器用户（如 www-data、nginx）对
runtime/有写权限（Docker/Nginx 部署常见权限问题）
仅在 HTML 响应中显示
Trace 面板不会出现在 JSON、XML 或 API 接口响应中，这是设计行为：
PHP 8.5.12
下载
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
- 访问一个返回完整 HTML 页面的路由（如
/、/index），右下角才会出现 Trace 图标 - 若用 Postman 或 curl 请求接口，看不到面板属正常，不代表没开启成功
让 SQL 标签页真正可用
Trace 中的 SQL 标签页内容来自日志系统，不是实时抓取。即使 APP_TRACE=true，若日志未记录 SQL，面板只显示数量，不展示语句：
- 打开
config/log.php，确认'level'数组包含'sql'，例如：'level' => ['error', 'sql', 'notice'] - 若使用自定义数据库连接（如读写分离），需确保所有连接都启用了
trace_sql（默认开启，但手动关闭过需复查） - SQL 按执行时间倒序排列，适合快速定位慢查询；完整上下文（哪行代码触发）仍需查
runtime/log/下的日志文件
不复杂但容易忽略
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
