ThinkPHP调试模式由APP_DEBUG常量在入口文件顶部定义决定，必须在框架加载前设置；.env中配置仅为后备，会被代码中define覆盖；开启后仍无错误页面需检查app_status和exception_handle配置。
ThinkPHP 调试模式不是靠“开启按钮”，而是由 APP_DEBUG 常量和环境配置共同决定的；设错位置或覆盖顺序不对，APP_DEBUG = true 也白搭。
APP_DEBUG 必须在框架加载前定义
ThinkPHP 在入口文件（通常是 public/index.php）中早期就检查 APP_DEBUG，一旦错过时机，后面怎么改都无效。
- ✅ 正确做法：在
public/index.php最顶部、require框架启动文件之前，直接写define('APP_DEBUG', true); - ❌ 错误做法：在
config/app.php里设'debug' => true，或在控制器里用define()—— 此时框架已初始化完毕，调试模式不会生效 - ⚠️ 注意：如果用了多入口或 CLI 启动（比如
think命令），每个入口都要单独定义APP_DEBUG
env 文件里的 APP_DEBUG 会被常量定义覆盖
ThinkPHP 5.1+ 支持 .env 文件，但它的 APP_DEBUG=true 只是“后备方案”——只要代码里显式调用了 define('APP_DEBUG', ...)，.env 的值就彻底失效。
- 常见陷阱：开发时在
.env设了APP_DEBUG=true，上线又加了define('APP_DEBUG', false)，结果发现调试信息还在显示 —— 很可能是测试环境没清缓存，或用了旧的入口文件 - 推荐做法：统一在入口文件控制，把
.env当作部署层配置，不依赖它开关调试模式 - 验证方式：打印
var_dump(defined('APP_DEBUG') && APP_DEBUG);，必须为true
调试模式开启后，错误页面不显示？检查 APP_STATUS 和异常处理配置
即使 APP_DEBUG = true，你也可能只看到空白页或 500，因为 ThinkPHP 默认会捕获异常并渲染友好提示，而这个行为受 app_status 和 exception_handle 影响。
立即学习“PHP免费学习笔记（深入）”；
- 确保
config/app.php中'app_status' => 'debug'（非必需，但配合调试更直观） - 检查是否自定义了
'exception_handle' => \think\exception\Handle::class—— 如果替换成自己的处理器，且没调用父类render()，错误堆栈就会被吞掉 - CLI 下调试需额外注意：
php think run默认不输出完整错误，加-v参数或改config/console.php的'verbose' => true
真正卡住人的地方，往往不是“怎么开”，而是“谁先定义、谁后生效、谁把它关掉了”。尤其是团队协作时，不同人改了不同入口、不同环境的配置，APP_DEBUG 实际值可能和你以为的完全不一样。
