Yii多语言需四块协同：入口处设language、正确配置messages路径、Url::to()显式传lang参数、formatter组件绑定locale。任一环节错位都会导致翻译失效或格式异常。
Yii 多语言不是设个 language 就能跑通的，漏掉 URL 路由初始化时机或翻译文件路径映射，页面文字不变、日期格式还是英文、切换链接直接 404——这些都不是配置没生效，而是四块咬合没对上。
怎么让 Yii::$app->language 在视图渲染前就起作用
常见错误是把语言设置写在 beforeAction() 或控制器 init() 里。这时 View、Formatter、验证器等组件已经按默认语言初始化完毕，再改 language 也晚了。
- 必须在应用入口
web/index.php中、Yii::createWebApplication()之后、$app->run()之前做 - 从
Yii::$app->request->getPathInfo()提取首段（如/zh-CN/site/index中的zh-CN），校验合法性后立即赋值：Yii::$app->language = $lang; - 别依赖
$_GET['lang']—— 开启美化 URL 后它通常为空；也别在UrlRule子类里改language，规则匹配发生在语言初始化之后
为什么 Yii::t() 翻译不出来，或总 fallback 到源语言
根本原因通常是消息源没加载到对应语言目录，或文件命名/路径不匹配。
-
basePath必须指向真实存在的目录，比如@app/messages，且该目录下要有zh-CN/、en-US/这样的子目录 - 子目录内 PHP 文件名要和
Yii::t()第一个参数（category）一致，例如Yii::t('app', 'Home')→ 对应@app/messages/zh-CN/app.php - 每个 PHP 文件必须以
return [...];结尾，键是源语言字符串，值是目标语言翻译，不能有语法错误或 BOM 头 - 若用
PhpMessageSource，确保sourceLanguage和实际源字符串语言一致（比如你代码里写的是中文，就设'sourceLanguage' => 'zh-CN'）
URL 带语言前缀时，Url::to() 为什么总丢掉 lang 段
Url::to() 默认不感知当前语言上下文，它只按路由规则拼地址，不会自动补 lang 参数。
- 所有内部跳转必须显式传参：
Url::to(['site/about', 'lang' => Yii::$app->language]) - 切换语言链接要先剥离当前路径中的语言段，再拼新前缀，否则会变成
/zh-CN/zh-CN/site/index—— 可用explode('/', trim(Yii::$app->request->getPathInfo(), '/'))取第一段判断后截断 - 不要指望
urlManager的rules自动注入lang，它只负责解析入向请求，不出向生成 - 项目里大量使用
Url::to()的话，建议封装一个LangUrl::to()工具方法，默认合并当前Yii::$app->language
日期、数字、货币格式为什么还是英文
这是最容易被忽略的一环：formatter 组件的语言绑定是独立于 i18n 的，必须单独配。
- 在
components中确认formatter已声明，且其locale属性设为Yii::$app->language（不是字符串字面量） - 例如：
'formatter' => ['class' => 'yii\i18n\Formatter', 'locale' => Yii::$app->language] - 注意：这个
locale值必须是 ICU 格式（如zh-CN、en-US），不是zh_cn或en_us - 如果用了自定义
View或提前渲染了内容（比如 layout 里调用了date()），确保 formatter 初始化早于这些调用
最麻烦的永远不是“怎么配”，而是四块——语言初始化时机、翻译文件加载路径、URL 出向生成逻辑、formatter 本地化——其中一块没卡准，整个多语言就处于“看起来配好了，但哪里都不对”的状态。
