You need to enable JavaScript to run this app. 如何使用Vue i18n翻译data/props对象中的字符串并支持语言切换实时更新
优惠活动
大模型
产品
解决方案
定价
更多

如何使用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的变化,导致渲染逻辑没有被重新触发。

修复方案

  1. 翻译逻辑不要直接静态赋值给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')
          }
        ]
      }
    }
    
  2. 模板中传入prop的翻译值,统一抽成计算属性返回后再传入,确保响应式依赖的链路完整:
    computed: {
      customComponentName() {
        return this.$t('main.custom_component_name')
      }
    }
    
    模板调用调整为:
    <MyCustomComponent :name="customComponentName" />
    
  3. 语言切换时使用官方提供的方法修改locale值,不要直接手动篡改locale状态的内部属性,保证响应式触发机制正常运行。

内容的提问来源于stack exchange,提问作者Andrew Rusinas

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 05:15:06