Yii2错误提示默认不走i18n翻译链，需显式用Yii::t()包装；模型验证错误须在addError前翻译，内置验证器错误需配置'yii' category并严格匹配源码字符串，异常页面和静态文本同理，路径、权限、缓存、sourceLanguage等配置错误会导致静默失败。
Yii2 的错误提示（如模型验证失败、系统异常）默认不走 i18n 翻译链，必须显式接入翻译机制，否则无论 language 怎么设，错误信息始终是英文或硬编码中文。
Yii::t() 必须用在 addError() 之前
模型验证错误不会自动翻译，$this->addError() 第二个参数是纯字符串，直接塞进去就固定了。想让它可翻译，得在调用前用 Yii::t() 包一层：
- 错误写法：
$this->addError('email', 'Email is not valid.');→ 永远显示英文 - 正确写法：
$this->addError('email', Yii::t('app', 'Email is not valid.'));→ 会按当前Yii::$app->language查@app/messages/zh-CN/app.php - category 名称（如
'app'）必须和 i18n 配置中fileMap键一致，否则查不到文件 - 如果错误消息含变量，用占位符：
Yii::t('app', 'The value "{value}" is not allowed.', ['value' => $v])
内置验证器错误怎么翻译
像 required、email 这类规则触发的错误，默认来自 yii category，不是 app。不单独配，就翻不了：
- i18n 配置里必须加
'yii' => ['class' => 'yii\i18n\PhpMessageSource', 'basePath' => '@app/messages'] - 对应文件路径是
@app/messages/zh-CN/yii.php，内容为：return ['{attribute} cannot be blank.' => '{attribute} 不能为空。']; - 注意：键名必须完全匹配 Yii 源码里写的原始字符串，大小写、标点都不能错；可用调试时
var_dump(Yii::$app->i18n->translate('yii', '{attribute} cannot be blank.', []))验证 - 若用了
frontend/backend高级模板，basePath要指向对应模块的messages目录，不能只写@app/messages
errorAction 页面里的错误提示怎么本地化
site/error 视图里显示的 $exception->getMessage() 或 $exception->getName() 默认不翻译，得手动处理：
- 不要直接 echo
$exception->getMessage()，改用：Yii::t('app', $exception->getMessage())（前提是该消息字符串已录入翻译文件） - 更稳妥的做法是按异常类型做映射：
if ($exception instanceof \yii\web\NotFoundHttpException) { echo Yii::t('app', 'Page not found'); } -
$statusCode（如 404、500）本身是数字，但描述性文字（如'Not Found'）要进yii.php翻译 - 视图中所有静态提示文字（如
'Back to homepage'）都必须套Yii::t()，否则语言切换后这部分永远不变
常见静默失败点
错误提示没翻译，90% 不是代码问题，而是环境或路径卡住了：
-
@app/messages/zh-CN/yii.php文件不存在，或权限为 600（Web 进程读不了）→Yii::t()静默返回原文 - 翻译文件里用了中文引号、全角空格，或末尾多了一个逗号 → PHP 解析失败，整个文件被忽略
- 修改了翻译内容但没清缓存：
rm -rf runtime/cache/*，否则 PhpMessageSource 仍用旧数组 -
sourceLanguage设成'zh-CN'，导致yii类的英文原文无法 fallback → 所有未翻译条目直接空白 - 在
SiteController::actionError()里改Yii::$app->language—— 太晚了，视图渲染已开始，formatter 和翻译缓存都初始化完了
最易被忽略的是：验证错误和异常页面的文本，和普通页面文本走的是同一套 i18n 配置，但它们的触发时机更靠后、上下文更窄，稍有路径或 category 不对，就彻底掉出翻译链——没有报错，只有沉默的原文。
