ThinkPHP调试模式必须在入口文件最顶部、框架加载前用define('APP_DEBUG', true)明确开启，这是所有版本唯一稳定生效的方式；配套需设置ini_set('display_errors', '1')、APP_TRACE=true并清空runtime目录。
ThinkPHP调试模式必须在入口文件最顶部、框架加载前用define('APP_DEBUG', true)明确开启，其他方式（如配置文件、.env）都是后备或辅助手段，且容易因顺序或缓存失效。
入口文件第一行定义APP_DEBUG
这是所有ThinkPHP版本（5/6/8）唯一稳定生效的方式：
- 打开入口文件：TP5 是项目根目录的
index.php；TP6/8 是public/index.php - 在
<?php后**立刻**写入，前面不能有任何空行、BOM、注释或输出：define('APP_DEBUG', true); - 确保这行在任何
require、include或框架加载语句之前 - 布尔值必须是
true，写成'true'、1或TRUE（大写）均无效
配套设置让调试真正可见
只开APP_DEBUG还不够，常见白屏或无Trace面板，往往卡在这几步：
- 在入口文件同一位置紧接添加：
ini_set('display_errors', '1');<br>error_reporting(E_ALL); - 启用Trace面板（右下角小图标）：在
.env中加APP_TRACE=true，或在入口文件加define('APP_TRACE', true) - Nginx+PHP-FPM环境下，确认
fastcgi_intercept_errors off;，否则Nginx会吞掉错误页 - TP6+需检查
config/app.php中'debug_show_exception' => true（仅当APP_DEBUG为true时才读取）
清空缓存才能生效
ThinkPHP会缓存配置和模板，改完不清理等于没改：
立即学习“PHP免费学习笔记（深入）”；
- 手动删除整个
runtime/目录（含子目录、隐藏文件如~runtime.php） - 不要只删部分子目录——
runtime/log/、runtime/cache/、runtime/template/都得清 - 若用Docker或CI/CD部署，确保构建步骤包含清缓存操作
环境变量（.env）只是后备方案
.env方便多环境管理，但优先级低于入口文件定义：
- 仅当入口文件**未定义**
APP_DEBUG时，.env中的APP_DEBUG=true才起作用 -
.env文件必须是UTF-8无BOM编码，等号两侧**不能有空格**：APP_DEBUG=true<br>APP_TRACE=true
- 修改
.env后同样要清空runtime/，否则旧缓存会沿用之前的判断结果 - TP8官方不推荐依赖
.env开关调试，因其可能绕过环境加载逻辑，导致App::isDebug()返回不准
