更新记录

1.1.0（2026-06-05） 下载此版本

新特性

• 整合原 locale 目录下的完整逻辑
• 内置多语言支持（中文、英文、日文）
• 新增 registerLocaleMessages 方法
• 新增 mergeLocaleMessages 方法
• 新增 mergeLocaleMessageByKey 方法
• 新增 getI18nConfig 方法
• 导出工具函数 createLocaleMessages、defineLocaleMessages、mergeLocaleMessages

改进

• 优化语言包合并逻辑
• 默认使用系统语言
• 改进 fallback 语言机制

平台兼容性

uni-app(3.7.9)

uni-app x(3.7.9)

其他

dk-i18n 国际化插件

一个功能完整的 uni-app 国际化插件，支持多语言切换和动态语言加载。

特性

• 内置多语言支持（中文、英文、日文）
• 支持语言动态注册和合并
• 支持 fallback 语言
• 支持参数插值
• 语言设置持久化存储
• 完全兼容原 locale 目录下的 API

安装

在 HBuilderX 中导入本插件即可使用。

使用说明

基础使用

import i18n from '@/uni_modules/dk-i18n/index.js'

// 初始化（可选，已内置默认语言包）
i18n.init()

// 使用翻译
console.log(i18n.t('index.title'))
console.log(i18n.t('hello'))

// 在模板中使用
<text>{{ $t('index.home') }}</text>

自定义初始化

i18n.init({
  locale: 'en',
  fallbackLocale: 'zh-Hans',
  messages: {
    'zh-Hans': {
      custom: '自定义文本'
    },
    'en': {
      custom: 'Custom text'
    }
  }
})

切换语言

i18n.setLocale('en')
console.log(i18n.getLocale())

动态注册语言包

import { defineLocaleMessages, mergeLocaleMessages } from '@/uni_modules/dk-i18n/index.js'

// 注册新语言
i18n.registerLocaleMessages('fr', {
  'hello': 'Bonjour'
})

// 合并语言包
i18n.mergeLocaleMessages({
  'zh-Hans': {
    'new.key': '新增的键'
  }
})

// 通过 key 合并语言包
const customMessages = {
  'custom.text': '自定义文本'
}
i18n.mergeLocaleMessageByKey('zh-Hans', customMessages)

获取配置

const config = i18n.getI18nConfig()
console.log(config.locale)
console.log(Object.keys(config.messages))

内置语言

插件已内置以下语言：

• zh-Hans - 简体中文
• zh-Hant - 繁体中文
• en - English
• ja - 日语

API 参考

实例方法

导出函数

目录结构

uni_modules/dk-i18n/
├── uniCloud/
├── components/
├── utssdk/
├── hybrid/
├── pages/
├── static/
├── wxcomponents/
├── locales/
│   ├── en.json
│   ├── zh-Hans.json
│   ├── zh-Hant.json
│   ├── ja.json
│   └── uni-app.ja.json
├── js_sdk/
│   └── index.js
├── index.js           # 入口文件（主）
├── license.md
├── package.json
├── readme.md
└── changelog.md

兼容性

• HBuilderX 3.1.0+
• uni-app 4.1.0+
• uni-app x 4.2.0+

更新日志

见 changelog.md

许可证

见 license.md