vue 实现双语言
Vue 实现双语言(国际化 i18n)
在 Vue 项目中实现双语言(国际化)通常使用 vue-i18n 插件。以下是具体实现步骤:
安装 vue-i18n 插件
通过 npm 或 yarn 安装 vue-i18n:
npm install vue-i18n
# 或
yarn add vue-i18n
配置多语言文件
创建语言资源文件,例如:
-
en.json(英文):{ "welcome": "Welcome", "button": { "submit": "Submit" } } -
zh.json(中文):{ "welcome": "欢迎", "button": { "submit": "提交" } }
初始化 i18n 实例
在 Vue 项目中初始化 vue-i18n,通常在 main.js 或单独模块中配置:

import Vue from 'vue'
import VueI18n from 'vue-i18n'
import en from './locales/en.json'
import zh from './locales/zh.json'
Vue.use(VueI18n)
const i18n = new VueI18n({
locale: 'en', // 默认语言
fallbackLocale: 'en', // 回退语言
messages: {
en,
zh
}
})
new Vue({
i18n,
render: h => h(App)
}).$mount('#app')
在组件中使用多语言
通过 $t 方法或指令绑定翻译内容:
<template>
<div>
<h1>{{ $t('welcome') }}</h1>
<button>{{ $t('button.submit') }}</button>
</div>
</template>
切换语言
通过修改 locale 实现语言切换:
// 切换到中文
this.$i18n.locale = 'zh'
// 切换到英文
this.$i18n.locale = 'en'
可以在按钮或下拉菜单中触发语言切换:

<select v-model="$i18n.locale">
<option value="en">English</option>
<option value="zh">中文</option>
</select>
动态加载语言包
若语言包较大,可以按需加载:
async function loadLocale(locale) {
const messages = await import(`./locales/${locale}.json`)
i18n.setLocaleMessage(locale, messages.default)
}
处理复数与变量插值
vue-i18n 支持复数形式和变量插值:
{
"cart": "You have {count} item in your cart | You have {count} items in your cart"
}
模板中使用:
<p>{{ $tc('cart', itemCount, { count: itemCount }) }}</p>
浏览器语言自动检测
通过 navigator.language 自动设置初始语言:
const browserLang = navigator.language.split('-')[0]
i18n.locale = ['en', 'zh'].includes(browserLang) ? browserLang : 'en'
注意事项
- 语言包需保持键名一致,仅值不同。
- 生产环境中建议将语言包拆分为异步加载模块以减少首屏体积。
- 对于日期/货币格式化,可使用
$d和$n方法。






