Yii2多语言生效需四步同步：启用intl扩展、显式配置i18n组件、构建正确翻译文件结构、实现可靠语言切换逻辑；缺一即导致翻译失效或格式异常。
装完 Yii2 后要让多语言真正跑起来，光改 language 配置远远不够。核心是四件事同步到位：intl 扩展启用、i18n 组件配置、翻译文件结构正确、语言切换逻辑可靠。漏掉任一环，就会出现“文字没变”“日期还是英文格式”“换语言后页面 404”这类静默失败。
先确认 intl 扩展已启用
Yii2 的本地化（日期、数字、货币格式）全靠 PHP 的 intl 扩展驱动。没有它，Yii::$app->formatter->asDate() 只能返回 ISO 格式字符串，不会显示“2026年6月4日”这种中文格式。
- Linux/macOS：运行
php -m | grep intl，有输出即表示已安装；若无，需执行sudo apt install php-intl（Ubuntu/Debian）或brew install php@X.X-intl（macOS） - Windows：打开
php.ini，取消注释extension=php_intl.dll，并确保icu*.dll文件在 PHP 的ext目录下且系统 PATH 可达 - 验证是否生效：新建一个 PHP 脚本，写
var_dump(\IntlDateFormatter::create('zh-CN'));，不报错且返回对象即成功
i18n 组件必须完整配置
不能只设 'language' => 'zh-CN' 就以为完事。i18n 是独立组件，需在 config/web.php 的 components 中显式声明，否则 Yii::t() 查不到翻译源。
-
sourceLanguage建议固定为'en-US'—— 这是你代码里写的原始字符串语言，便于团队协作和工具提取（如./yii message） -
basePath指向@app/messages，目录结构应为：@app/messages/zh-CN/app.php、@app/messages/en-US/app.php -
fileMap必须配对：比如'app' => 'app.php'，那么Yii::t('app', 'Login')才会去读对应语言目录下的app.php - 通配符规则更实用：
'app*' => ['class' => 'yii\i18n\PhpMessageSource', 'basePath' => '@app/messages']，可覆盖app、app/error等所有以app开头的 category
语言切换不能只改一次 Yii::$app->language
在控制器动作里临时赋值，只影响当前请求。刷新页面就回退，因为应用启动时已按旧语言加载过翻译缓存。
- 统一入口处理：在
AppController::init()中读取 session 或 cookie，再设置Yii::$app->language - 保存语言选择：切换时写入 session，例如
Yii::$app->session->set('_lang', 'ja-JP')；也可用 cookie 实现跨会话记忆 - 避免 URL 参数硬编码：不要在 config 里写
'language' => $_GET['lang']，既不安全又无法 fallback。应由控制器校验后赋值 - URL 路由需配合：加
'<lang:>/<controller:>/<action:>' => '<controller>/<action>'</action></controller></action:></controller:></lang:>规则，并放在普通规则之前；同时在匹配后手动设语言，例如在 Bootstrap 或 UrlManager 解析后执行
翻译文件命名与内容要规范
文件位置错、命名错、数组写法错，都会导致 Yii::t() 静默返回原文，控制台还不报错，极难排查。
- 目录名必须是标准语言标签，如
zh-CN、en-US、ja-JP，不能写zh或chinese - PHP 文件必须用
return [ ... ];包裹，键是源语言字符串（区分大小写），值是目标语言翻译，例如'Home' => '首页' - category 名称中不能含空格或斜杠以外的特殊字符；若要用子分类，如
app/auth，则fileMap中需明确写'app/auth' => 'auth.php' - 建议用
./yii message命令自动提取源码中的Yii::t()字符串，生成模板后再人工翻译，避免遗漏
