Translation组件不自动响应语言变化，因其设计为静态渲染，仅挂载时读取一次语言；必须用useTranslation Hook或withTranslation高阶组件订阅变更，或手动监听languageChanged事件并forceUpdate。

Translation 组件不自动响应语言变化？

React 中的 Translation 组件（来自 i18next-react）本身是静态渲染的，它只在挂载时读取一次当前语言，后续调用 i18n.changeLanguage() 不会触发重渲染——除非你显式让它订阅语言变更。

常见表现：切换语言后，页面文字没变，但 i18n.language 已更新，控制台也无报错。

• 必须用 useTranslation Hook 或包裹 withTranslation 高阶组件，才能让组件响应语言变更
• Translation 是纯展示组件，设计上就不含订阅逻辑；它的作用只是按传入的 ns 和 key 渲染对应文案
• 如果你硬要用 Translation，得手动监听 i18n.on('languageChanged', ...) 并调用 forceUpdate，不推荐

切换语言时丢失当前命名空间（ns）？

调用 i18n.changeLanguage('zh') 后，如果某些文案显示为 key 本身（如 header.title），大概率是目标语言的对应命名空间未加载完成或未正确初始化。

典型场景：项目用了 code-splitting 按需加载语言包，但切换时没 await 对应 import 的 Promise。

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

• 确保语言资源通过 addResourceBundle 注册完成后再调用 changeLanguage
• 若用 loadNamespaces，需显式等待：await i18n.loadNamespaces(['common', 'page'], 'zh')
• 检查 i18n.options.fallbackLng 是否设为 false；设为 false 且目标语言缺 ns 时，不会降级回 fallback，直接返回 key

如何安全地在非 React 组件里触发语言切换？

比如在工具函数、路由守卫、或 Class Component 中调用语言切换，容易因 i18n 实例未就绪而静默失败。

错误写法：i18n.changeLanguage('ja') 在 i18n.isInitialized === false 时会直接忽略。

• 始终检查 i18n.isInitialized，未初始化时先 await i18n.init()（注意：重复 init 会警告但不报错）
• 更稳妥的做法是封装一个 safeChangeLanguage 函数，内部做 ready 状态等待和错误捕获
• Class Component 中不要在 componentWillMount 里切语言——该生命周期已废弃，且此时 i18n 可能还没注入；改用 componentDidMount + isInitialized 判断

使用 useTranslation 时 key 命名冲突怎么办？

多个模块共用同一命名空间（如 common）时，不同团队提交的 key 可能重复，导致文案覆盖或缺失。

现象：切到某语言后，部分按钮文字变成其他页面的描述，或者整个区块文案消失。

• 避免全局 flat key，强制采用模块前缀：login.submitButton 而不是 submitButton
• 开发期启用 returnEmptyString: false 和 returnNull: false，让缺失 key 抛出警告而非静默渲染空字符串
• CI 流程中加入 key 冲突校验脚本，扫描所有 en.json 和 zh.json，比对 key 数量与结构一致性

实际项目里最常被忽略的，是语言切换后组件内状态（比如表单输入值、展开折叠态）没重置，用户以为“语言变了，界面也该刷新”，结果发现只是文案换了个壳，交互逻辑还卡在旧语言上下文里。这不属于 Translation 的职责，但恰恰是多语言体验断层的主因。