vue3+Ant-design-vue3+i18n实现多语言切换功能

 更新时间:2026年04月10日 09:20:48   作者:kobe_OKOK_  
这篇文章主要为大家详细介绍了如何通过vue3+Ant-design-vue3+i18n实现多语言切换功能,文中的示例代码讲解详细,感兴趣的小伙伴可以了解下

vue-i18n + Ant Design Vue locale + 本地缓存

这样:

  • 页面文字切换
  • Ant组件语言同步
  • 日期组件语言同步
  • 表格语言同步
  • 分页语言同步
  • 刷新记住语言

这是生产项目标准方案。下面给你完整企业实现。

一、安装依赖

npm install vue-i18n

Vue3:

必须:

npm install vue-i18n@9

二、创建语言目录

推荐结构:

src/
locales/
zh-cn.js
zh-tw.js
en.js
index.js

三、语言文件

简体中文

// locales/zh-cn.js
export default {
menu:{
dashboard:"首页",
factory:"工厂",
device:"设备",
sensor:"传感器"
},
button:{
save:"保存",
cancel:"取消"
}
}

繁体中文

// locales/zh-tw.js
export default {
menu:{
dashboard:"首頁",
factory:"工廠",
device:"設備",
sensor:"感測器"
},
button:{
save:"保存",
cancel:"取消"
}
}

English

// locales/en.js
export default {
menu:{
dashboard:"Dashboard",
factory:"Factory",
device:"Device",
sensor:"Sensor"
},
button:{
save:"Save",
cancel:"Cancel"
}
}

四、创建 i18n 配置

locales/index.js

import { createI18n } from 'vue-i18n'
import zhCN from './zh-cn'
import zhTW from './zh-tw'
import en from './en'
const i18n=createI18n({
legacy:false,
locale:
localStorage.getItem("lang")
||"zh-cn",
fallbackLocale:"en",
messages:{
"zh-cn":zhCN,
"zh-tw":zhTW,
"en":en
}
})
export default i18n

五、main.js 注册

import { createApp } from 'vue'
import App from './App.vue'
import router from './router'
import i18n from './locales'
createApp(App)
.use(router)
.use(i18n)
.mount('#app')

必须:

.use(i18n)

否则:$t 不生效

六、页面使用

Vue3:

<script setup>
import { useI18n } from 'vue-i18n'
const { t }=useI18n()
</script>
<template>
<div>
{{t('menu.factory')}}
</div>
</template>

不要:{{$t()}}

那是Vue2写法。

七、语言切换实现

创建:composables/useLang.js

import { useI18n } from 'vue-i18n'
export function useLang(){
const { locale }=useI18n()
const changeLang=(lang)=>{
locale.value=lang
localStorage.setItem(
"lang",
lang
)
}
return{
locale,
changeLang
}
}

八、语言切换组件

例如 Header:

<script setup>
import { useLang } from '@/composables/useLang'
const {
locale,
changeLang
}=useLang()
</script>
<template>
<a-select
style="width:120px"
:value="locale"
@change="changeLang"
>
<a-select-option value="zh-cn">
简体中文
</a-select-option>
<a-select-option value="zh-tw">
繁體中文
</a-select-option>
<a-select-option value="en">
English
</a-select-option>
</a-select>
</template>

九、Ant Design Vue 组件语言同步(重要)

Ant组件不会自动跟随。

需要:

import zhCN from 'ant-design-vue/es/locale/zh_CN'
import zhTW from 'ant-design-vue/es/locale/zh_TW'
import enUS from 'ant-design-vue/es/locale/en_US'

创建:utils/antdLocale.js

import zhCN from 'ant-design-vue/es/locale/zh_CN'
import zhTW from 'ant-design-vue/es/locale/zh_TW'
import enUS from 'ant-design-vue/es/locale/en_US'
export function getAntLocale(lang){
if(lang==="zh-cn"){
return zhCN
}
if(lang==="zh-tw"){
return zhTW
}
return enUS
}

十、App.vue配置

<script setup>
import { useLang } from './composables/useLang'
import { getAntLocale } from './utils/antdLocale'
const { locale }=useLang()
</script>
<template>
<a-config-provider
:locale="getAntLocale(locale)"
>
<router-view/>
</a-config-provider>
</template>

这样:

Ant:

  • Pagination
  • Table
  • DatePicker
  • Modal
  • Form

全部同步语言。

十一、企业推荐优化(自动检测浏览器)

自动选择:

const lang=
localStorage.getItem("lang")
||
navigator.language
||
"en"

转换:

if(lang.includes("zh")){
locale="zh-cn"
}

工业系统常见。

十二、企业推荐最终结构

推荐:

src/

locales/

en.js
zh-cn.js
zh-tw.js
index.js

composables/

useLang.js

utils/

antdLocale.js

components/

LangSwitch.vue

大型项目必须模块化。

十三、工业系统推荐增强(生产级)

真实项目还会加:

  • 动态加载语言包
  • 后端返回语言
  • 权限菜单翻译
  • 表格列翻译
  • API错误翻译
  • 日期格式翻译
  • moment dayjs同步
  • Echarts语言同步

工业IoT必做:

设备状态:

在线 → Online
离线 → Offline
报警 → Alarm

统一语言包。

十四、企业级最终方案(推荐)

生产项目通常:

i18n/

modules/

menu.js
device.js
factory.js
sensor.js
alarm.js
common.js

不是一个文件。

否则几万行

到此这篇关于vue3+Ant-design-vue3+i18n实现多语言切换功能的文章就介绍到这了,更多相关vue3多语言切换内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 一文教会你快速上手vue的登录界面(最新版)

    一文教会你快速上手vue的登录界面(最新版)

    几乎每个项目都会使用登录页面,这篇文章主要给大家介绍了如何通过一文教会你快速上手vue的登录界面,文中通过实例代码介绍的很详细,需要的朋友可以参考下
    2022-11-11
  • 关于Vue.js一些问题和思考学习笔记(2)

    关于Vue.js一些问题和思考学习笔记(2)

    这篇文章主要为大家分享了关于Vue.js一些问题和思考的学习笔记,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2016-12-12
  • vue项目兼容ie11的实现方法

    vue项目兼容ie11的实现方法

    本文主要介绍了vue项目兼容ie11的实现方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-08-08
  • Vue中this.$refs的使用及说明

    Vue中this.$refs的使用及说明

    Vue中this.$refs用于访问通过ref注册的元素或组件,需在mounted后使用,可在JS操作DOM或调用子组件方法,注意避免模板中直接使用
    2025-08-08
  • Vue v-model组件封装(类似弹窗组件)

    Vue v-model组件封装(类似弹窗组件)

    这篇文章主要介绍了Vue中的 v-model组件封装(类似弹窗组件),本文给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-01-01
  • 在vue中获取微信支付code及code被占用问题的解决方法

    在vue中获取微信支付code及code被占用问题的解决方法

    这篇文章主要介绍了在vue中获取微信支付code及code被占用问题的解决方法。小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2019-04-04
  • vue3基础教程之pinia配置和用法

    vue3基础教程之pinia配置和用法

    Vue3项目常用Pinia管理状态,通过安装和配置实现数据持久化,这篇文章主要介绍了vue3基础教程之pinia配置和用法的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
    2025-06-06
  • vue开发中如何在js文件里使用pinia和组件同步

    vue开发中如何在js文件里使用pinia和组件同步

    在JavaScript文件中封装涉及到使用Pinia的方法时,发现Pinia和组件内容并不同步,二者的状态是独立的,解决办法是,在新建对象的时候,将Pinia作为参数传入,本文给大家介绍vue开发中如何在js文件里使用pinia和组件同步,感兴趣的朋友一起看看吧
    2024-10-10
  • 使用VUE+iView+.Net Core上传图片的方法示例

    使用VUE+iView+.Net Core上传图片的方法示例

    这篇文章主要介绍了使用VUE+iView+.Net Core上传图片的方法示例,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2019-01-01
  • elementUi 中table表尾插入行的实例

    elementUi 中table表尾插入行的实例

    这篇文章主要介绍了elementUi 中table表尾插入行的实例,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-07-07

最新评论