在ThinkPHP框架开发中，开启调试模式是排查错误和优化代码的基础操作。调试模式开启后，系统会显示详细报错、日志记录以及性能信息，大幅提升开发效率。
ThinkPHP5开启调试模式的方法
ThinkPHP5通常在应用配置文件或入口文件中开启调试。最常见的是修改 config/app.php 中的 app_debug 参数。
方法一：修改配置文件
打开项目中的 application/config.php 或 config/app.php，找到如下配置项并设为 true：
<?php
// 配置文件 config/app.php
return [
// 应用调试模式
'app_debug' => true,
// 应用Trace
'app_trace' => true,
];
方法二：在入口文件定义常量
也可以在 public/index.php 入口文件顶部定义调试常量，优先级高于配置文件。
<?php
// 定义应用目录
define('APP_PATH', __DIR__ . '/../application/');
// 开启调试模式
define('APP_DEBUG', true);
// 加载框架引导文件
require __DIR__ . '/../thinkphp/start.php';
ThinkPHP6开启调试模式的方法
ThinkPHP6使用了环境变量机制，调试开关主要由根目录下的 .env 文件控制。
通过.env文件配置
在项目根目录创建或编辑 .env 文件，设置 APP_DEBUG 为 true：
APP_DEBUG = true APP_TRACE = true
通过config文件兜底
如果不存在 .env 文件，可修改 config/app.php 中的 app_debug 配置：
<?php
return [
// 是否开启调试模式
'app_debug' => true,
];
调试模式下的常见功能
- 页面报错信息详细展示，包含文件和行号
- 底部Trace信息显示SQL语句与执行时间
- 日志自动记录到
runtime/log目录
注意事项
调试模式仅用于开发环境，上线前必须关闭，否则会暴露服务器路径和数据库信息，造成安全风险。
如果在浏览器中访问 127.0.0.1 本地服务，修改配置后清掉 runtime/cache 缓存再刷新页面，调试信息才会正常出现。