ThinkPHP调试模式仅通过入口文件顶部定义的APP_DEBUG常量生效，TP5/6/8均适用；.env仅在未显式定义该常量时起作用；开启后触发模板重编译、缓存失效、SQL日志默认启用等底层机制切换。
ThinkPHP调试模式只认 APP_DEBUG 这个常量，且必须在入口文件最顶部、框架加载前定义，其他任何地方改都无效。
入口文件必须第一行就写 define('APP_DEBUG', true)
这是唯一权威生效的位置。TP5/6/8 全部适用，不看 config、不读 .env、不认 URL 参数。
- 打开
public/index.php（TP6/8）或项目根目录的index.php（TP5） - 在
<?php后**立刻**插入这行，前面不能有任何输出、空行、BOM 或注释 - 这行之后才能出现
require、include或任何框架加载逻辑 - 写成
define('APP_DEBUG', false)就是关，别用字符串'true'或数字1
.env 文件只在没显式定义 APP_DEBUG 时才起作用
很多人以为改 .env 就能开调试，结果没反应——大概率是入口文件里已经写了 define，把 .env 覆盖掉了。
-
.env中写APP_DEBUG=true是有效的，但前提是入口文件里**没有**define('APP_DEBUG', ...) - TP8 官方明确不鼓励在入口文件写
define，因为会绕过环境加载逻辑，导致App::isDebug()返回不准 - 如果用了
.env，务必确认文件是 UTF-8 无 BOM 编码，等号两侧不能有空格 - 改完
.env必须清空runtime/目录，否则缓存会让配置不生效
开了 APP_DEBUG 却看不到错误页面？检查这三处
常见现象是页面空白、500、或者只有“系统繁忙”，不是没开，而是被拦在了 PHP 层或 Nginx 层。
立即学习“PHP免费学习笔记（深入）”；
- 入口文件顶部加
ini_set('display_errors', '1')，强制 PHP 输出错误（别依赖 php.ini） - Nginx + PHP-FPM 环境下，检查
fastcgi_intercept_errors on;是否开启——必须设为off，否则 Nginx 会吞掉 ThinkPHP 的错误页 - TP6+ 默认不显示详细异常页面，需在
config/app.php中显式配'debug_show_exception' => true（仅当APP_DEBUG === true时才读取）
APP_DEBUG = true 不只是显示堆栈，它会改变一整套行为
真正容易被忽略的是：它不只是“多看几行报错”，而是触发了底层机制切换。
- 模板引擎不再使用编译缓存，每次请求都重新解析，所以修改模板不用手动删
runtime/template/ - 路由、配置、容器等所有缓存自动失效，
runtime/cache/里一堆文件会频繁重建 - SQL 日志默认开启，如果数据库配置里没关
'log' => ['enable' => false]，敏感参数可能直接打到日志里 - 自定义异常处理器中调用
$this->isDebug()，返回值取决于APP_DEBUG常量，不是 config 配置项
