必须在入口文件最顶部、框架加载前定义APP_DEBUG常量，如define('APP_DEBUG', true)；.env中的APP_DEBUG仅在未显式定义时生效；开启后启用异常堆栈、模板重编译、缓存失效等调试功能。
如何在 ThinkPHP 中动态开启或关闭调试模式
调试模式不是靠改 PHP 代码里的某个开关变量临时生效的，而是由
常量决定，且必须在框架加载前定义。你改了
里的
配置项，但没提前定义
，那它根本不会读——ThinkPHP 启动时就根据
决定要不要加载调试相关组件。
实操建议：
在入口文件（如
）最顶部、
框架之前，直接定义：
或
不要在
里写
就以为开启了——这个配置只在
时才被读取并生效
线上环境务必确保
为
，否则会暴露敏感路径、SQL 和变量 dump
为什么修改 .env 文件不生效
ThinkPHP 6+ 支持
，但默认只读取
，且仅当
未被显式定义时才 fallback 到
。也就是说：如果你已经在入口文件写了
，那
里写
完全没用。
常见错误现象：
立即学习
“
PHP免费学习笔记（深入）
”；
改了
，
启动后页面还是不显示调试工具栏
返回
，但
明明写了
原因就是入口文件已硬编码覆盖。解决办法只有一个：删掉入口文件里的
，让框架自己从
加载。
调试模式开启后哪些功能实际被启用
开启
不只是多一个 toolbar，它会触发一整套行为变更，影响日志、异常处理、模板编译甚至路由缓存。
关键影响点：
异常页面显示完整堆栈、变量、SQL（含绑定参数），但生产环境绝对不能开
模板引擎强制重新编译，每次请求都解析
，性能下降明显
路由、配置、语言包等缓存全部失效，所有
调用退化为内存数组操作
日志写入级别降到
，且默认输出到
，路径错误时可能报
如何安全地在不同环境间切换调试模式
靠手动改代码太容易出错，推荐用环境变量 + 入口判断组合。比如 Nginx/Apache 设置
，再在入口统一处理：
这样既避免硬编码污染，又防止本地开发误推
到线上。
容易被忽略的一点：CLI 环境（比如运行
）不会自动读
，必须用
或在命令前显式 export 环境变量，否则 CLI 下的
始终是
。
APP_DEBUGconfig/app.phpdebugAPP_DEBUGAPP_DEBUGpublic/index.phprequiredefine('APP_DEBUG', true);define('APP_DEBUG', $_SERVER['APP_ENV'] === 'local');config/app.php'debug' => trueAPP_DEBUG === trueAPP_DEBUGfalse.envAPP_DEBUGAPP_DEBUG.envdefine('APP_DEBUG', false).envAPP_DEBUG=true.envphp think runvar_dump(\think\facade\App::debug());false.envAPP_DEBUG=truedefine('APP_DEBUG', ...).envAPP_DEBUG.htmlcache()debugruntime/log/mkdir(): Permission deniedAPP_ENV=productionif (!defined('APP_DEBUG')) {
define('APP_DEBUG', $_ENV['APP_ENV'] === 'local' || $_ENV['APP_ENV'] === 'dev');
}APP_DEBUG=truephp think queue:work.envphp -d variables_order=EGPCS think ...APP_DEBUGfalse