通过 Upwork 认识我? 如果您是通过 Upwork 找到我并希望合作,请通过 Upwork 联系我。Upwork 客户在 Upwork 之外发送的消息将不会得到回复。
本地化笔记🌏 本地化

Vue.js 和 Nuxt.js 越南语本地化:vue-i18n 配置指南

越南语名词没有语法复数,vue-i18n 消息文件只需一种形式。介绍如何为 Vue 或 Nuxt 应用配置越南语 locale、hreflang 和懒加载。

Dao Huy (Lucas)5分钟8 节
Vue.js 和 Nuxt.js 越南语本地化:vue-i18n 配置指南
💡 摘要:在 vue-i18n 中添加 vi 作为 locale,并在 Nuxt 配置中设置 language: 'vi-VN' 以生成正确的 hreflang 标签。越南语在 Unicode CLDR 中只有 "other" 一个复数类别,名词没有语法性复数变化,因此一条消息字符串可处理所有数量情形。在根布局中调用 useLocaleHead() 即可自动生成 Google 所需的越南语 hreflang 标签。

要点

  • vue-i18n 中使用 vi 作为 locale 代码;在 Nuxt 的 locales 数组里设置 language: 'vi-VN' 以生成符合 BCP 47 规范的 hreflang 标签。
  • 越南语没有语法复数(Unicode CLDR 仅有 "other" 类别),无需配置 pluralizationRules。
  • 通过 file: 'vi.json' 启用懒加载,避免越南语字符串增大初始 JS bundle。
  • 将 locale JSON 文件保存为 UTF-8 无 BOM 格式,BOM 标记可能导致越南语变音符号在某些解析器中出现乱码。
  • 在根布局中调用 useLocaleHead({ addSeoAttributes: true }),一次性注入 hreflang、canonical 和 og:locale 元标签。

越南语的复数规则比英文简单得多

越南语通过数词和量词表达数量,名词本身不发生形态变化。"1 sản phẩm"(1 个产品)和 "10 sản phẩm"(10 个产品)结构完全相同。Unicode CLDR 只给越南语分配了 "other" 这一个复数类别,意味着每个 key 只需一条消息字符串,与数量无关。

相比之下,英文需要 "one" 和 "other" 两种形式,法文也类似。您的 vi.json 文件完全不需要管道符分隔的变体:

// en.json
{
  "cartItems": "No items | One item | {count} items"
}

// vi.json - 只需一种形式,无需管道符
{
  "cartItems": "{count} sản phẩm"
}

如果业务规则需要对零值特殊处理(例如显示"购物车为空"),建议在组件逻辑中判断,而不是依赖 vue-i18n 的复数化功能。

如何在 vue-i18n 中配置越南语 locale?

使用 vi 作为 locale 代码。W3C 建议 BCP 47 标签尽量简短,-VN 地区子标签对 vue-i18n 的消息匹配没有实际意义,因为越南语只有一套标准书写规范。在 createI18n() 中进行配置:

import { createI18n } from 'vue-i18n'

const i18n = createI18n({
  locale: 'vi',
  fallbackLocale: 'en',
  messages: {
    vi: {
      welcome: 'Chào mừng, {name}!',
      cartItems: '{count} sản phẩm',
      checkout: 'Thanh toán ngay'
    }
  }
})

无需 pluralizationRules 选项。Vue i18n 的默认规则对所有数值都返回 "other",这正是越南语所需的正确行为。

Nuxt i18n 如何为越南语生成 hreflang?

Nuxt i18n v10 使用 @nuxtjs/i18n 模块。生成 hreflang 时,每个 locale 对象的 language 属性必须是 BCP 47 标签,同时设置 baseUrl 确保 alternate URL 完整:

// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@nuxtjs/i18n'],
  i18n: {
    locales: [
      { code: 'en', language: 'en-US', file: 'en.json' },
      { code: 'vi', language: 'vi-VN', file: 'vi.json' }
    ],
    defaultLocale: 'en',
    baseUrl: 'https://your-domain.com',
    strategy: 'prefix_except_default'
  }
})

prefix_except_default 策略让英文保留根 URL,越南语使用 /vi/ 前缀,使 Google 能将两者识别为独立的语言版本。在根布局中调用 useLocaleHead({ addSeoAttributes: true }),该 composable 会为每个页面自动生成 <link rel="alternate" hreflang="vi-VN">,同时添加 x-default 备用链接和 canonical URL。

越南语翻译文件需要懒加载吗?

需要。如果越南语不是默认 locale,将其字符串打包进初始 JS chunk 会对非越南语用户造成不必要的带宽浪费。在每个 locale 对象上使用 file 键启用懒加载,Nuxt i18n 只在用户导航到越南语路由时才加载 vi.json,并在 session 内进行缓存:

// locales/vi.json
{
  "home": {
    "hero": "Giải pháp dịch thuật chuyên nghiệp",
    "cta": "Yêu cầu báo giá"
  },
  "nav": {
    "about": "Giới thiệu",
    "contact": "Liên hệ"
  }
}

编码注意事项:所有 locale JSON 文件必须保存为 UTF-8 无 BOM 格式。越南语变音符号(U+1E00 至 U+1EFF)使用 3 字节 UTF-8 编码。Windows 编辑器有时会添加字节顺序标记,导致某些 JSON 解析器出现乱码。

哪些工作可以内部完成,何时需要越南语专家?

上述所有技术配置(vue-i18n 接入、Nuxt 配置、hreflang、懒加载)均可由开发团队自主完成。DeepL 和 Google 翻译等机器翻译工具对简单的越南语 UI 字符串处理效果较好。

以下情况建议引入越南语母语专家:

  • 语体选择:越南语有正式(kính/quý khách)和非正式(bạn)两种语体。金融或医疗应用中语体用错,会立即降低越南用户的信任度。
  • 汉越词术语:金融、法律和医疗词汇通常有两种越南语对应词,汉越词(正式、专业)和纯越南语(通俗易懂)。两者的选择是文化判断,机器翻译无法准确处理。
  • 短 UI 字符串:缺乏上下文的按钮标签和错误提示是机器翻译在越南语中最容易出错的地方。由母语审校者结合实际 app 界面进行检查,能在上线前发现这类问题。

由越南语母语专家对机器翻译初稿进行一天审校,其成本通常远低于上线后因用户反馈而重新翻译的费用。本站的越南语网站与应用本地化服务提供兼顾技术细节的人工审校,专为 Vue 和 Nuxt 项目设计。

常见问题

vue-i18n 中应该使用 vi 还是 vi-VN 作为 locale 代码?

vue-i18n 的 locale 设置和文件名中使用 vi(如 vi.json)。在 Nuxt i18n 的 locales 数组中设置 language: 'vi-VN' 以生成 hreflang 标签。两个设置用途不同:前者用于 vue-i18n 消息匹配,后者用于向搜索引擎发送语言信号。

越南语在 vue-i18n 中需要配置 pluralizationRules 吗?

不需要。越南语没有语法复数,Unicode CLDR 只分配了 "other" 类别。Vue i18n 的默认规则对所有数值返回 "other",完全符合越南语的需求。跳过 pluralizationRules 选项,直接编写单一形式的消息字符串即可。

如何测试越南语 hreflang 标签是否正确?

构建网站后查看页面 HTML 源代码,确认存在 <link rel="alternate" hreflang="vi-VN"> 标签,且 href 为完整 URL(https://...)。部署后使用 Google Search Console 的 URL 检查工具确认 Google 已正确解析 hreflang。同时验证是否存在指向默认 locale 页面的 x-default 备用链接。

越南语字符串显示为乱码,原因是什么?

最常见的原因是 locale JSON 文件含有 UTF-8 BOM。检查 VS Code 状态栏:若显示"UTF-8 with BOM"则需重新保存为"UTF-8"。另一常见原因是使用 Windows PowerShell 5.x 的 Get-Content 读取文件,该命令默认使用 Windows-1252 编码,会损坏越南语多字节字符。请始终使用 Node.js fs 函数(readFileSync(path, 'utf8'))读写 locale 文件。

Vue SPA 和 Nuxt 应用可以共用同一套 vue-i18n 消息文件吗?

可以。vue-i18n 是两者共同的底层库。JSON 消息文件格式、插值语法和复数规则完全相同。Nuxt 只是在此基础上增加了路由、hreflang 和懒加载功能。从 Vue SPA 迁移到 Nuxt 时,现有的 locales/vi.json 文件无需修改即可直接使用。

参考来源

Dao Huy (Lucas)
Dao Huy (Lucas)
岘港大学外国语大学毕业。每份认证翻译均附签名的准确性声明(USCIS、IRCC)。

作者:Đào Huy(Lucas),越南语译员与本地化专家(英、中、法译越)。 See translation services →

报价WhatsApp