如何使用Vue i18n翻译data/props对象中的字符串并支持语言切换实时更新
Vuei18n 多语言切换后翻译值不更新的处理方案
日常使用 Vuei18n 做多语言适配时,常见的翻译调用场景有两类:
- 翻译结果直接赋值给组件的data对象,在组件初始化时一次性取值,示例写法:
data() { return { title: this.$t('main.title'), stuff: [ { name: this.$t('main.name_1') }, { name: this.$t('main.name_2') } ] } } - 模板中给自定义组件传prop时,直接调用
$t方法生成翻译值传入,示例写法:<MyCustomComponent :name="$t('main.custom_component_name')" />
异常表现
切换全局locale语言时,上述两类场景下的翻译字符串不会自动重新加载;但模板中直接绑定的翻译字符串,能正常随语言切换即时更新。
问题原因
出现这类现象的核心,是响应式的依赖追踪链路断了:
- 直接在data中调用
this.$t()赋值时,取值动作仅发生在组件初始化的瞬时,最终存到data里的是当时locale对应的固定字符串,并没有和全局的locale状态建立响应式关联。后续locale切换时,这个固定存储的字符串不会触发重新计算,自然无法更新。 - 模板中直接调用
$t传prop的场景,正常Vue的模板渲染逻辑会在依赖变化时重新执行渲染函数,拿到最新翻译值;如果出现不更新的情况,通常是旧版本vue-i18n没有将locale状态暴露为响应式变量,或是渲染上下文没有追踪到locale的变化,导致渲染逻辑没有被重新触发。
修复方案
- 翻译逻辑不要直接静态赋值给data,改用计算属性承载。计算属性会自动追踪内部
$t方法对locale状态的依赖,locale变化时会自动重新计算,返回最新的翻译结果。
改写示例:computed: { title() { return this.$t('main.title') }, stuff() { return [ { name: this.$t('main.name_1') }, { name: this.$t('main.name_2') } ] } } - 模板中传入prop的翻译值,统一抽成计算属性返回后再传入,确保响应式依赖的链路完整:
模板调用调整为:computed: { customComponentName() { return this.$t('main.custom_component_name') } }<MyCustomComponent :name="customComponentName" /> - 语言切换时使用官方提供的方法修改locale值,不要直接手动篡改locale状态的内部属性,保证响应式触发机制正常运行。
内容的提问来源于stack exchange,提问作者Andrew Rusinas
相关产品推荐
相关产品推荐

