当前位置：首页 > news >正文

在 UniApp 项目中设置多语言

news 2025/7/3 23:36:41

在 UniApp 项目中设置多语言支持可以通过以下步骤实现：

1. 安装依赖

首先，你需要安装 vue-i18n 插件来处理多语言支持。

npm install vue-i18n --save

2. 创建语言文件

在项目中创建一个 lang 文件夹，用于存放不同语言的翻译文件。例如：

src/
├── lang/
│   ├── en.js
│   ├── zh-CN.js
│   └── zh-TW.js

每个语言文件导出一个对象，包含该语言的翻译内容。例如 en.js：

export default {
  welcome: 'Welcome',
  greeting: 'Hello, {name}!',
  // 其他翻译...
}

zh-CN.js：

export default {
  welcome: '欢迎',
  greeting: '你好, {name}!',
  // 其他翻译...
}

3. 配置 `vue-i18n`

在 src 目录下创建一个 i18n.js 文件，用于配置 vue-i18n。

import Vue from 'vue'
import VueI18n from 'vue-i18n'
import en from './lang/en'
import zhCN from './lang/zh-CN'
import zhTW from './lang/zh-TW'

Vue.use(VueI18n)

const messages = {
  en,
  'zh-CN': zhCN,
  'zh-TW': zhTW
}

const i18n = new VueI18n({
  locale: 'zh-CN', // 默认语言
  fallbackLocale: 'en', // 回退语言
  messages
})

export default i18n

4. 在 `main.js` 中引入 `i18n`

在 main.js 中引入并挂载 i18n。

import Vue from 'vue'
import App from './App'
import i18n from './i18n'

Vue.config.productionTip = false

const app = new Vue({
  i18n,
  ...App
})

app.$mount()

5. 在组件中使用多语言

在组件中，你可以使用 $t 方法来获取翻译内容。

<template>
  <view>
    <text>{{ $t('welcome') }}</text>
    <text>{{ $t('greeting', { name: 'John' }) }}</text>
  </view>
</template>

<script>
export default {
  name: 'MyComponent'
}
</script>

6. 切换语言

你可以通过修改 locale 来切换语言。

this.$i18n.locale = 'en' // 切换到英文

7. 持久化语言设置

为了在应用重启后保持用户选择的语言，你可以将语言设置存储在本地存储中。

// 设置语言
this.$i18n.locale = 'en'
uni.setStorageSync('locale', 'en')

// 获取语言
const locale = uni.getStorageSync('locale') || 'zh-CN'
this.$i18n.locale = locale

8. 处理动态加载语言文件（可选）

如果语言文件较大，可以考虑动态加载语言文件。

async function setLocale(locale) {
  const messages = await import(`@/lang/${locale}.js`)
  this.$i18n.setLocaleMessage(locale, messages.default)
  this.$i18n.locale = locale
}