ThinkPHP调试模式的核心开关是APP_DEBUG常量，必须在入口文件最顶部、框架加载前以布尔值true/false定义；其他配置仅在其未显式定义时生效，开启后启用错误堆栈、SQL日志、Trace面板等功能，关闭则进入生产模式。
ThinkPHP调试模式的核心开关是APP_DEBUG常量，它必须在入口文件最顶部、框架加载前定义，类型必须为布尔true或false。其他配置（如.env、config/app.php）仅在该常量未被显式定义时才起作用。开启后会启用完整错误堆栈、SQL日志、Trace面板、模板强制重编译等功能；关闭后这些全部失效，系统进入生产行为模式。
入口文件定义是最可靠的方式
这是所有ThinkPHP版本（5.x/6.x/8.x）唯一无条件识别的开启途径：
- TP5：编辑项目根目录下的
index.php，在<?php后第一行插入：define('APP_DEBUG', true); - TP6/8：编辑
public/index.php，同样放在<?php后、任何require之前 - 若使用多入口（如
admin.php、api.php），每个都要单独添加 - 写成
'true'（字符串）或1（数字）均无效，必须是true
.env文件作为环境变量管理方案
适合团队协作与多环境部署，但有明确前提：
- 入口文件中不能存在
define('APP_DEBUG', ...)语句，否则.env会被完全忽略 - 确保项目根目录有
.env文件（UTF-8无BOM编码），内容为：APP_DEBUG=true<br>APP_TRACE=true
等号两侧不可有空格 - TP6+默认支持
.env，TP5需确认已启用dotenv扩展 - 修改后必须清空
runtime/目录（含子目录和隐藏文件），否则缓存可能掩盖新配置
配套设置提升调试效率
仅开启APP_DEBUG还不够，还需激活关键子功能：
立即学习“PHP免费学习笔记（深入）”；
- 右下角Trace面板：需同时设置
APP_TRACE=true（可通过.env或入口文件ini_set方式） - SQL日志可见：数据库配置中确保
'log_sql' => true - 模板实时生效：在
config/template.php中设'auto_cache' => false - PHP底层错误输出：在入口文件
define后立即加两行：ini_set('display_errors', '1');<br>error_reporting(E_ALL);
关闭调试模式的注意事项
线上环境必须彻底关闭，避免敏感信息泄露：
- 首选方式：将入口文件中的
define('APP_DEBUG', true)改为false，并清空runtime/ - 若用
.env管理，需先删除入口文件里的define语句，再设APP_DEBUG=false - 不要只改
config/app.php里的app_debug项——它不控制开关，只在APP_DEBUG === true时生效 - 验证是否关闭成功：
var_dump(\think\facade\App::debug());应返回bool(false)，且页面无Trace图标、无异常堆栈
