在 Vue3 项目中实现多语言支持并从服务端获取配置,可以使用 Vue I18n 库。在初始化阶段可以发送请求获取多语言配置或者通过本地文件加载json文件的方式,都可以实现。我这里是tauri项目,所以使用的是invoke从tauri端拿到配置文件,然后根据配置文件获取多语言配置。
Vue3 项目配置多语言支持(从服务端获取配置)
在 Vue3 项目中实现多语言支持并从服务端获取配置,可以使用 Vue I18n 库。以下是完整的实现方案:
1. 安装依赖
首先安装 vue-i18n:
npm install vue-i18n@next
2. 基础配置
创建 i18n 实例
// src/i18n.js
import { createI18n } from 'vue-i18n'const i18n = createI18n({legacy: false, // 使用 Composition API 模式locale: 'en', // 默认语言fallbackLocale: 'en', // 回退语言messages: {}, // 初始为空,从服务端加载silentTranslationWarn: true // 禁止警告
})export default i18n
在 main.js 中引入
import { createApp } from 'vue'
import App from './App.vue'
import i18n from './i18n'const app = createApp(App)
app.use(i18n)
app.mount('#app')
3. 从服务端获取语言配置
创建 API 服务
// src/api/i18n.js
import axios from 'axios'export async function fetchTranslations(lang) {try {const response = await axios.get(`/api/translations/${lang}`)return response.data} catch (error) {console.error('Error fetching translations:', error)return {}}
}
动态加载语言
// src/utils/i18n-loader.js
import { fetchTranslations } from '@/api/i18n'export async function loadLanguageAsync(i18n, lang) {if (i18n.global.locale.value === lang) {return Promise.resolve()}// 如果已经加载过该语言,直接设置if (i18n.global.availableLocales.includes(lang)) {i18n.global.locale.value = langreturn Promise.resolve()}// 从服务器获取翻译const messages = await fetchTranslations(lang)// 设置语言i18n.global.setLocaleMessage(lang, messages)i18n.global.locale.value = lang// 可以在这里保存语言偏好到本地存储localStorage.setItem('userLanguage', lang)return Promise.resolve()
}
4. 在应用中使用
语言切换组件示例
<template><div><select v-model="currentLocale" @change="changeLanguage"><option value="en">English</option><option value="zh">中文</option><option value="es">Español</option></select></div>
</template><script setup>
import { ref, watch } from 'vue'
import { useI18n } from 'vue-i18n'
import { loadLanguageAsync } from '@/utils/i18n-loader'const { locale } = useI18n()
const currentLocale = ref(locale.value)// 初始化时加载用户偏好语言
const initLanguage = async () => {const savedLanguage = localStorage.getItem('userLanguage') || navigator.language.slice(0, 2)await loadLanguageAsync(i18n, savedLanguage)currentLocale.value = savedLanguage
}initLanguage()const changeLanguage = async () => {await loadLanguageAsync(i18n, currentLocale.value)
}
</script>
在组件中使用翻译
<template><div><h1>{{ t('welcome') }}</h1><p>{{ t('greeting', { name: 'John' }) }}</p></div>
</template><script setup>
import { useI18n } from 'vue-i18n'const { t } = useI18n()
</script>
5. 服务端 API 设计
服务端应该提供一个端点返回指定语言的翻译,例如:
GET /api/translations/:lang
响应格式示例:
{"welcome": "Welcome","greeting": "Hello, {name}!","buttons": {"submit": "Submit","cancel": "Cancel"}
}
6. 高级优化
缓存策略
// 修改 i18n-loader.js
const translationCache = new Map()export async function loadLanguageAsync(i18n, lang) {// ... 前面的代码// 检查缓存if (translationCache.has(lang)) {i18n.global.setLocaleMessage(lang, translationCache.get(lang))i18n.global.locale.value = langreturn Promise.resolve()}// 从服务器获取const messages = await fetchTranslations(lang)translationCache.set(lang, messages)// ... 后面的代码
}
加载状态
// 添加加载状态管理
const loadingLanguages = new Set()export async function loadLanguageAsync(i18n, lang) {if (loadingLanguages.has(lang)) {return}loadingLanguages.add(lang)try {// ... 加载逻辑} finally {loadingLanguages.delete(lang)}
}
错误处理
export async function loadLanguageAsync(i18n, lang) {try {// ... 加载逻辑} catch (error) {console.error(`Failed to load language ${lang}:`, error)// 回退到默认语言if (lang !== i18n.global.fallbackLocale.value) {i18n.global.locale.value = i18n.global.fallbackLocale.value}throw error}
}
7. TypeScript 支持 (可选)
为翻译键添加类型支持:
// src/i18n.d.ts
declare module 'vue-i18n' {export interface DefineLocaleMessage {welcome: stringgreeting: stringbuttons: {submit: stringcancel: string}// 添加更多翻译键...}
}
这样在组件中使用 t()
函数时会有类型提示和检查。
通过以上步骤,你的 Vue3 应用就可以从服务端动态加载多语言配置,并支持语言切换功能了。