Vue / 系统课时

国际化与本地化

国际化与本地化

企业应用的国际化不只是把中文替换成英文,还要统一管理文案、语言切换、日期、数字和货币格式。本节用 Vue 3、TypeScript 与 vue-i18n 建立可扩展的本地化入口,并处理动态参数和缺失翻译的边界。

学习目标

  • 用类型化语言包组织静态文案与动态插值。
  • 用 vue-i18n 统一日期、数字和货币的本地化展示。
  • 设计运行时语言切换与缺失翻译的兜底策略。

划清国际化与本地化职责

国际化负责让代码具备切换语言和地区的能力,本地化负责为具体 locale 提供正确文案与格式。业务组件不应自行判断“中文就拼人民币符号、英文就拼美元符号”,而应把原始数据交给统一格式化层。

推荐把可翻译文本写成稳定 key,例如 order.status.paid;把语言包按 locale 组织;金额、百分比和日期则保留原始值。这样切换语言只改变展示层,不会修改业务状态或接口协议。

建立语言包与格式化入口

下面使用组合式 API 建立最小配置。为了突出核心关系,示例把语言包写在同一文件中;大型项目可以进一步按业务模块拆分并按需加载。

ts
import { createI18n } from 'vue-i18n'

export const i18n = createI18n({
  legacy: false,
  locale: 'zh-CN',
  fallbackLocale: 'en-US',
  messages: {
    'zh-CN': {
      order: {
        title: '订单 {id}',
        paid: '已支付',
      },
    },
    'en-US': {
      order: {
        title: 'Order {id}',
        paid: 'Paid',
      },
    },
  },
  datetimeFormats: {
    'zh-CN': {
      short: { year: 'numeric', month: '2-digit', day: '2-digit' },
    },
    'en-US': {
      short: { year: 'numeric', month: 'short', day: '2-digit' },
    },
  },
  numberFormats: {
    'zh-CN': {
      money: { style: 'currency', currency: 'CNY' },
    },
    'en-US': {
      money: { style: 'currency', currency: 'USD' },
    },
  },
})

这段配置属于应用初始化代码片段,需要在 main.ts 中通过 app.use(i18n) 注册。注册后,组件可以使用 t、d、n 分别处理文案、日期和数字;当前语言缺少 key 时,fallbackLocale 会尝试使用基准语言。

在组件中处理动态文案

动态句子应通过插值参数传值,而不是在模板中拼接字符串。不同语言的词序可能完全不同,插值可以让翻译者调整整句话,同时保持订单号等业务值不变。

vue
<script setup lang="ts">
import { computed } from 'vue'
import { useI18n } from 'vue-i18n'

const { t, d, n, locale } = useI18n()

const orderId = 'A1024'
const paidAt = new Date('2026-09-04T01:30:00+08:00')
const total = 1288.5

const nextLocale = computed(() =>
  locale.value === 'zh-CN' ? 'en-US' : 'zh-CN',
)

function switchLocale() {
  locale.value = nextLocale.value
}
</script>

<template>
  <section>
    <h2>{{ t('order.title', { id: orderId }) }}</h2>
    <p>{{ t('order.paid') }}</p>
    <p>{{ d(paidAt, 'short') }}</p>
    <p>{{ n(total, 'money') }}</p>
    <button type="button" @click="switchLocale">
      切换到 {{ nextLocale }}
    </button>
  </section>
</template>

预期结果

text
初始 locale 为 zh-CN:
订单 A1024
已支付
<DATE>
<CNY_VALUE>

点击按钮切换为 en-US:
Order A1024
Paid
<DATE>
<USD_VALUE>

<DATE>、<CNY_VALUE> 和 <USD_VALUE> 的具体符号、空格与分隔形式由运行环境的国际化数据决定,实际值可能不同。验收时应确认语言、币种和日期格式随 locale 一起变化,而不是把格式化后的完整字符串写死。

按需加载语言并保存偏好

大型应用通常不需要在首屏加载全部语言包。切换时应先确认目标 locale,再动态导入语言模块,调用 setLocaleMessage 注册内容,最后修改 locale.value。这样可以避免网络较慢时界面短暂显示翻译 key 或错误的回退语言。

用户语言来源也需要明确优先级。企业系统通常优先读取账号级偏好,其次读取本地持久化设置,首次访问才参考 navigator.language。浏览器返回的地区不一定受系统支持,因此还需要把 zh-SG、en-AU 等候选值映射到应用实际提供的 locale。

路由标题、侧边菜单、表单校验和通知消息都应读取同一个当前 locale。若各模块自行保存语言状态,就容易出现主体页面已经切换,而导航栏或 Toast 仍显示旧语言的问题。

避免把格式化变成业务计算

金额本地化只负责显示,不负责换汇。CNY 100 与 USD 100 是两个不同的业务值;如果需要根据汇率转换,应先由业务层明确计算目标金额,再交给格式化函数展示。

日期同样不要先转成本地化字符串再进入全局状态。接口和状态层应保存时间戳或 ISO 时间,组件根据当前 locale、时区和业务需求格式化。这样同一份原始数据才能在不同地区用户的界面中正确展示。

缺失翻译在开发环境应尽早暴露,生产环境可以回退到基准语言,但不要静默显示空字符串。可维护的国际化方案,本质上是把会随语言和地区变化的文案与展示规则集中到可检查、可切换的边界内。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

国际化与本地化

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通