标签： $this->forceTranslation

本文分析了 Yii 2 高级项目模板中，当目标语言为美国英语且文件映射类别名为 app 时，消息翻译未被映射到 PHP 文件的 Bug。通过调试发现，I18N 组件仅对第一层类别进行判断，导致自定义 app 类别被核心定义覆盖且 forceTranslation 值为 false。解决方案是将类别名及对应翻译文件从 app 重命名为 application，并更新配置代码与调用方法，从而确保消息被正确映射和翻译。