ThinkPHP6+调试模式唯一取决于APP_DEBUG环境变量，须在.env中严格写为APP_DEBUG=true（无空格、无引号、UTF-8无BOM），并清除runtime缓存、Web服务器显式传递该变量，否则静默失效。
APP_DEBUG 必须写在 .env 文件里，且格式不能错
ThinkPHP 6+ 和 8.0 的调试模式只认 APP_DEBUG 这个环境变量，它必须在 PHP 启动早期就存在，.env 是最常用、也最推荐的设置位置。但很多人写了却没效果，根本原因是格式不对：
-
APP_DEBUG=true—— 正确：等号两侧**绝对不能有空格**，也不能加引号 -
APP_DEBUG = true、APP_DEBUG="true"、APP_DEBUG: true—— 全部无效 - 文件编码必须是 UTF-8 无 BOM；VS Code 保存时选“Save with Encoding → UTF-8 (no BOM)”
- 如果项目根目录下已有
runtime/目录，改完.env后必须**手动删除整个runtime/目录**，否则缓存会掩盖新配置
Web 环境下 Nginx/Apache 必须显式传递 APP_DEBUG
即使 .env 写对了，Web 请求仍可能不生效——因为 PHP-FPM 默认不把系统环境变量透传给子进程。Nginx 需要在 fastcgi_param 中补一句：
fastcgi_param APP_DEBUG $APP_DEBUG;
Apache 则需确认启用了 PassEnv 或用 SetEnv 显式设置：
SetEnv APP_DEBUG true
- 漏掉这步，
$_ENV['APP_DEBUG']和getenv('APP_DEBUG')都为空 - 可通过
var_dump($_ENV)或dump(env('APP_DEBUG'))在控制器里验证是否真被读到 - CLI 或 Swoole 启动方式不受此限制，但要确保启动前已加载
.env（如通过App::loadEnv()）
别让入口文件 define('APP_DEBUG', ...) 覆盖 .env 设置
有些老项目或迁移代码会在 public/index.php 里硬编码：
立即学习“PHP免费学习笔记（深入）”；
define('APP_DEBUG', true);
只要这行存在，.env 里的 APP_DEBUG 就完全失效。检查入口文件，删掉或注释掉这类定义。
- ThinkPHP 官方逻辑是：先看是否已定义常量
APP_DEBUG，有则直接用；没有才去查环境变量 - 多环境部署时，硬编码会让
.env.prod等切换失去意义 - 如果必须保留入口判断，改用
if (!defined('APP_DEBUG')) { define('APP_DEBUG', env('APP_DEBUG', false)); }
验证 APP_DEBUG 是否真正生效的三个动作
光看 .env 写没写对不够，得确认框架内部是否按预期响应：
- 访问任意路由，在控制器中加
dump(config('app.debug'));—— 输出true才算成功 - 故意触发一个错误（比如调用不存在的方法），页面应显示 ThinkPHP 原生调试页，含 Trace、SQL、变量堆栈；若只报 500 或空白，说明没生效
- 检查
runtime/log/下是否有当天的 debug 日志文件，且内容包含 SQL 绑定参数和完整调用链
最容易被忽略的是 BOM 头和 runtime 缓存——这两个问题不会报错，只会静默失败。
