调试模式未启用会导致ThinkPHP项目无法显示错误堆栈、SQL日志或Trace面板；需依次检查入口文件define('APP_DEBUG', true)、.env配置、PHP错误显示设置、app.php中app_debug项，并用var_dump验证常量是否为true。
如果您在开发ThinkPHP项目时无法看到详细的错误堆栈、SQL日志或右下角Trace调试面板，则很可能是调试模式未正确启用。以下是多种可靠且版本兼容的开启方法：
一、在入口文件顶部定义APP_DEBUG常量
此方式适用于所有ThinkPHP版本（5.x/6.x/8.x），是框架最早期识别调试状态的唯一权威途径，必须在加载框架前执行，否则无效。
1、打开项目入口文件，通常为public/index.php（TP6/8）或index.php（TP5）。
2、在文件最顶部、任何require或include语句之前插入以下代码：define('APP_DEBUG', true);
立即学习“PHP免费学习笔记（深入）”；
3、删除runtime/目录下全部内容（含~runtime.php），清除缓存。
4、刷新页面，若出现完整异常堆栈或右下角Trace小图标，则表示生效。
二、通过.env环境文件配置
.env文件具有配置优先级（仅当APP_DEBUG未被显式定义时生效），能统一管理多环境变量，符合现代PHP工程规范；但需确保其编码为UTF-8无BOM、等号两侧无空格，并清空runtime缓存。
1、确认项目根目录存在.env文件（若无，复制.example.env并重命名为.env）。
2、用纯文本编辑器打开该文件，在空白行中写入以下两行：APP_DEBUG=true
APP_TRACE=true
3、确保runtime/目录可写，并手动清空其中所有子目录与文件。
4、访问任意HTTP页面，检查右下角是否出现Trace调试面板图标。
三、启用PHP底层错误显示
即使APP_DEBUG为true，若PHP自身禁用了错误输出，框架也无法渲染调试页面；此步骤专用于Nginx+PHP-FPM或共享主机等常见屏蔽场景。
1、在入口文件public/index.php最顶部、define('APP_DEBUG', true)之后立即添加：ini_set('display_errors', '1');
2、在同一位置追加：error_reporting(E_ALL);
3、若使用Nginx+PHP-FPM，还需确认fastcgi_params中未覆盖PHP_VALUE关闭错误显示。
4、验证php.ini中是否设置display_errors = On且error_reporting = E_ALL。
四、检查config/app.php中的app_debug配置项
该配置项仅在APP_DEBUG === true的前提下被框架读取，单独修改此处无效；可用于确认调试上下文是否已激活，或配合TP5旧版部署习惯使用。
1、打开config/app.php文件（TP5路径为application/config.php）。
2、查找'app_debug'键名，将其值设为true：'app_debug' => true,
3、注意：若同时存在.env或入口文件中的define('APP_DEBUG', )，此配置将被忽略。
4、清空runtime/cache/目录以确保配置重载。
五、验证调试模式是否真正生效
仅依赖界面现象易误判，必须通过代码级检测确认APP_DEBUG常量是否被正确定义并为真值。
1、在任意控制器或入口文件末尾添加：var_dump(defined('APP_DEBUG') && APP_DEBUG);
2、执行后输出bool(true)才表示调试模式已真正启用。
3、若输出false，请回溯检查是否被其他define语句覆盖、.env未生效或runtime缓存未清除。
4、在CLI环境下运行php think run时，需额外添加-v参数或配置config/console.php中'verbose' => true。
