最稳方式是直接修改项目根目录的.env文件，它优先级高于config/app.php，需确保utf-8无bom编码、等号无空格、清空runtime缓存，且避免在入口文件用define覆盖环境配置。
直接改 .env 是最稳的方式
ThinkPHP 8 默认优先读取项目根目录的 .env 文件，它比 config/app.php 里的 app_debug 配置级别更高，也更符合现代 PHP 项目的环境隔离习惯。只要这个文件存在且格式正确，APP_DEBUG 和 APP_TRACE 就会按它生效，config/app.php 里的同名配置会被覆盖。
- 确认项目根目录有
.env（若无，复制.example.env并重命名） - 确保内容是纯 ASCII 编码（UTF-8 无 BOM），否则可能静默失效
- 写入两行即可，注意等号两侧不能有空格：
APP_DEBUG=trueAPP_TRACE=true - 改完后清空
runtime/目录（尤其是runtime/cache和runtime/container），否则旧缓存可能让改动不立即体现
别在入口文件用 define('APP_DEBUG', true)
TP8 官方明确不鼓励在 public/index.php 中用 define('APP_DEBUG', true) 的方式开启调试——这不是“不能用”，而是它会绕过环境加载逻辑，导致 .env 配置失效、App::isDebug() 判断不准，甚至影响异常处理器的环境识别。
- 常见错误现象：页面右下角没出现 Trace 面板，但日志里却有 SQL 记录 →
APP_TRACE没随APP_DEBUG一起生效 - 生产环境部署后仍显示详细错误 → 入口文件残留了
define，而.env被 Git 忽略或未同步 - 自定义异常处理器中
$this->isDebug()返回false→ 环境判断失准，日志记录策略错乱
APP_TRACE=true 不等于能看到所有 SQL
APP_TRACE=true 只是让右下角小面板可见，但它展示的信息深度取决于你是否同时开启了对应通道的日志。比如面板里看到 “SQL: 12 条”，但点不开具体语句，大概率是 config/log.php 里没配 'sql' 级别。
- 检查
config/log.php中的'level'是否包含'sql'：return [ 'level' => ['error', 'sql', 'notice'], ]; - Trace 面板默认只在 HTML 响应中渲染；如果接口返回 JSON，它不会出现——这不是 bug，是设计如此
- 想看某次请求的完整 SQL 执行顺序？打开 Trace 后，点击面板里的 “SQL” 标签页，它会按执行时间排序，比手动查日志更快定位慢查询
上线前关掉调试模式不只是改一个配置
把 APP_DEBUG=false 写进 .env 是基础，但真正上线时容易漏掉三件事：日志残留、Trace 面板残留、错误信息意外暴露。
- 确保
runtime/log/下没有敏感调试日志被误提交或未清理 - 确认
APP_TRACE=false已同步设置，否则 Trace 面板可能仍在 HTML 响应中渲染 - 检查是否还有自定义异常处理器、中间件或钩子中硬编码了
if (App::isDebug())并输出了堆栈或变量
环境配置不是开关一拨就完事的事，.env 的编码、缓存清理、日志通道联动、响应类型适配，每一步都可能卡住调试信息的显隐逻辑。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
