yii框架调试模式通过yii_debug常量控制，语法在1.x、2.x、3.x中通用，但效果不同：1.1显示堆栈并启用日志栏，2.x自动加载debug模块，3.x需单独安装yii-debug包；生产环境必须设为false以避免性能与安全风险。
Yii框架的调试模式靠 YII_DEBUG 常量控制，开启或关闭只需改这一行代码，不依赖具体版本，Yii 1.x、2.x、3.x 都通用。但实际效果和配套行为（比如日志量、错误页细节、性能影响）会因版本差异而不同。
怎么开启或关闭
在入口文件（如 web/index.php 或 console/yii）顶部，找到或添加这行：
- 开启调试：
defined('YII_DEBUG') or define('YII_DEBUG', true); - 关闭调试：
defined('YII_DEBUG') or define('YII_DEBUG', false);
注意必须放在 require Yii.php 和应用启动之前；如果被后续配置覆盖（例如某 config 文件里又写了 define('YII_DEBUG', true)），以最后一次定义为准。
三个版本是否真“通用”
语法层面是通用的——所有主流 Yii 版本都读这个常量。但关键区别在于：
- Yii 1.1：开启后显示详细错误堆栈、启用 CWebLogRoute 日志、自动加载调试工具栏（需手动配）
-
Yii 2.x：开启后自动加载
yii\debug\Module（需配置）、记录 SQL/变量快照、错误页带调用链和上下文变量 -
Yii 3.x：不再内置 debug 模块，
YII_DEBUG主要影响日志级别和部分组件行为（如异常处理器输出格式），debug 功能需单独装yiisoft/yii-debug包并启用
生产环境务必关掉
无论哪个版本，只要 YII_DEBUG === true，都会带来明显开销：
- 每个请求多记录数十条日志，高频访问下 I/O 成瓶颈
- SQL 查询会被完整捕获并序列化，拖慢数据库操作
- 错误页面暴露路径、类名、环境变量，有安全风险
- OPcache 可能被绕过，失去字节码缓存收益
上线前请确认：入口文件中是 false，且没有其他地方重复定义为 true；同时建议配合 YII_ENV = 'prod' 使用，双重保险。
