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多语言切换内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • 解决vuecli3中img src 的引入问题

    解决vuecli3中img src 的引入问题

    这篇文章主要介绍了解决vuecli3中img src 的引入问题,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2020-08-08
  • vue实现未登录跳转到登录页面的方法

    vue实现未登录跳转到登录页面的方法

    这篇文章主要介绍了vue实现未登录跳转到登录页面的方法,主要目的是实现未登录跳转,需要的朋友参考下吧
    2018-07-07
  • vue+elementUI实现分页效果

    vue+elementUI实现分页效果

    这篇文章主要为大家详细介绍了vue+elementUI实现分页效果,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-07-07
  • vxetable的高亮行不显示的问题及解决

    vxetable的高亮行不显示的问题及解决

    这篇文章主要介绍了vxetable的高亮行不显示的问题及解决,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2025-05-05
  • vue中echarts视图不更新问题及解决

    vue中echarts视图不更新问题及解决

    这篇文章主要介绍了vue中echarts视图不更新问题及解决方案,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-07-07
  • vue3实现区域打印功能过程(vue3-print-nb)

    vue3实现区域打印功能过程(vue3-print-nb)

    本文讲解Vue3中使用vue3-print-nb插件实现区域打印,包含安装、引入、HTML及参数配置步骤,支持灵活定位打印,推荐相关技术如Print.js、Pinia、二维码生成等
    2025-07-07
  • vue移动端城市三级联动组件使用详解

    vue移动端城市三级联动组件使用详解

    这篇文章主要为大家详细介绍了vue移动端城市三级联动组件的使用,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-07-07
  • Vue中遍历数组的新方法实例详解

    Vue中遍历数组的新方法实例详解

    这篇文章主要介绍了Vue中遍历数组的新方法,本文通过实例代码给大家介绍的非常详细,具有一定的参考借鉴价值,需要的朋友可以参考下
    2019-07-07
  • vue分割面板封装实现记录

    vue分割面板封装实现记录

    这篇文章主要为大家详细介绍了vue分割面板封装实现记录,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-03-03
  • Vue3异步数据加载组件suspense的使用方法

    Vue3异步数据加载组件suspense的使用方法

    前端开发中异步请求是非常常见的事情,比如远程读取图片,调用后端接口等等,这篇文章主要给大家介绍了关于Vue3异步数据加载组件suspense的使用方法,suspense中文含义是悬念的意思,需要的朋友可以参考下
    2021-08-08

最新评论