APP_DEBUG必须在应用启动前定义，入口文件顶部define('APP_DEBUG', true)最可靠；.env仅在未定义常量时生效；config/app.php中设置不独立生效；运行时调用config()或Config::set()无效。
app_debug 参数必须在应用启动前就确定，不能靠运行时动态设置生效。它控制整个调试模式是否开启，影响错误显示、Trace面板、SQL日志等关键开发功能。
入口文件顶部定义（最可靠）
这是 ThinkPHP 5.1 识别调试状态的底层机制，优先级最高：
- 打开 public/index.php（或项目根目录下的入口文件）
- 在 标签后第一行立即写入：
define('APP_DEBUG', true); - 确保这行代码出现在任何
require、include或框架加载语句之前 - 清空 runtime/ 目录下全部内容（包括缓存和隐藏文件）
.env 文件配置（TP5.1 支持，但需注意限制）
TP5.1 后期版本支持 .env，但仅当入口文件未定义 APP_DEBUG 常量时才生效：
- 在项目根目录创建或编辑 .env 文件（不是 application 目录下）
- 写入严格格式（等号两侧无空格）：
APP_DEBUG=true<br>APP_TRACE=true
- 确认 runtime/ 目录可写，并清空其内容
- 若已定义常量，.env 中的 APP_DEBUG 将被完全忽略
config/app.php 中设置（仅辅助，不独立生效）
这个配置项本身不会触发调试模式，只在 APP_DEBUG === true 的前提下被读取：
立即学习“PHP免费学习笔记（深入）”；
- 打开 config/app.php
- 找到并修改：
'app_debug' => true, - 单独改这里不会开启调试；它主要用于模块级覆盖（如某模块单独启用调试）或旧部署习惯兼容
- 修改后仍需清空 runtime 缓存
不能用 config() 或 Config::set() 动态设置
app_debug 属于系统级关键参数，框架明确禁止运行时修改：
-
config('app_debug', true)或Config::set('app_debug', true)不起作用 - 即使执行了，后续请求中该值也不会被识别为调试开启依据
- 其他类似参数如
app_trace、default_filter同样受限
