Bạn biết tôi qua Upwork? Nếu bạn biết tôi qua Upwork và muốn sử dụng dịch vụ, vui lòng liên hệ qua Upwork. Tin nhắn từ khách Upwork gửi ngoài Upwork sẽ không được trả lời.
Ghi chú bản địa hóa🌏 Bản địa hóa

Bản địa hóa Vue.js và Nuxt.js sang tiếng Việt: hướng dẫn vue-i18n

Tiếng Việt không có số nhiều ngữ pháp, giúp đơn giản hóa file dịch thuật vue-i18n. Hướng dẫn cấu hình locale, hreflang và lazy-loading cho ứng dụng Vue hoặc Nuxt.

Dao Huy (Lucas)5 phút đọc8 mục
Bản địa hóa Vue.js và Nuxt.js sang tiếng Việt: hướng dẫn vue-i18n
💡 Tóm tắt: Thêm vi làm locale trong vue-i18n và đặt language: 'vi-VN' trong Nuxt để tạo thẻ hreflang đúng chuẩn. Tiếng Việt không có số nhiều ngữ pháp: Unicode CLDR chỉ gán danh mục "other", nên một chuỗi tin nhắn duy nhất đáp ứng mọi con số. Dùng useLocaleHead() trong layout gốc để tự động tạo thẻ hreflang cho Google.

Ý chính

  • Dùng vi trong vue-i18n; đặt language: 'vi-VN' trong Nuxt để tạo thẻ hreflang BCP 47 mà Google chấp nhận.
  • Tiếng Việt không có số nhiều ngữ pháp (Unicode CLDR chỉ có category "other") - không cần tùy chọn pluralizationRules.
  • Bật lazy-loading với file: 'vi.json' cho mỗi locale để không tăng kích thước JS bundle ban đầu.
  • Lưu file JSON locale dưới dạng UTF-8 không có BOM - BOM có thể gây lỗi dấu tiếng Việt trong một số trình phân tích JSON.
  • Gọi useLocaleHead({ addSeoAttributes: true }) trong root layout để tự động thêm hreflang, canonical và og:locale trong một composable.

Tại sao số nhiều tiếng Việt đơn giản hơn tiếng Anh

Tiếng Việt diễn đạt số lượng bằng số đếm và loại từ, không thay đổi hình thức danh từ. "1 sản phẩm" và "10 sản phẩm" có cấu trúc giống hệt nhau. Unicode CLDR chỉ gán một danh mục duy nhất là "other" cho tiếng Việt, nghĩa là bạn chỉ cần một chuỗi tin nhắn cho mỗi key.

So sánh với tiếng Anh cần "one" và "other", hoặc tiếng Pháp cũng dùng hai dạng. File vi.json không cần các biến thể phân cách bằng dấu gạch đứng:

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

// vi.json - một dạng duy nhất, không cần dấu |
{
  "cartItems": "{count} sản phẩm"
}

Nếu có yêu cầu kinh doanh đặc biệt cho trường hợp bằng 0 (ví dụ "Giỏ hàng trống"), hãy xử lý trong logic component thay vì dùng pluralization của vue-i18n.

Cấu hình locale tiếng Việt trong vue-i18n như thế nào?

Dùng vi làm mã locale. W3C khuyến nghị giữ BCP 47 tag càng ngắn càng tốt: subtag khu vực -VN không có giá trị phân biệt cho vue-i18n vì chỉ có một chuẩn chính tả tiếng Việt. Cấu hình trong 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'
    }
  }
})

Không cần tùy chọn pluralizationRules. Rule mặc định của Vue i18n trả về "other" cho mọi giá trị số, đây là hành vi chính xác cho tiếng Việt.

Nuxt i18n tạo hreflang cho tiếng Việt ra sao?

Nuxt i18n v10 dùng module @nuxtjs/i18n. Để tạo hreflang, thuộc tính language trên mỗi đối tượng locale phải là BCP 47 tag, và cần đặt baseUrl để URL alternate đầy đủ:

// 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://ten-mien-cua-ban.com',
    strategy: 'prefix_except_default'
  }
})

Chiến lược prefix_except_default giữ tiếng Anh ở URL gốc và tiếng Việt ở tiền tố /vi/, giúp Google index chúng như hai phiên bản ngôn ngữ riêng biệt. Gọi useLocaleHead({ addSeoAttributes: true }) trong root layout để tự động tạo <link rel="alternate" hreflang="vi-VN"> cho mỗi trang, cùng với x-default, canonical URL và thẻ og:locale.

Có nên lazy-load bản dịch tiếng Việt không?

Có. Nếu tiếng Việt không phải là locale mặc định, việc đóng gói chuỗi tiếng Việt vào JS bundle ban đầu gây lãng phí băng thông cho người dùng không dùng tiếng Việt. Dùng key file trên mỗi locale object để bật lazy-loading - Nuxt i18n chỉ tải vi.json khi người dùng điều hướng đến route tiếng Việt, rồi cache cho phiên làm việc:

// 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ệ"
  }
}

Lưu ý về encoding: lưu tất cả file JSON locale dạng UTF-8 không BOM. Dấu tiếng Việt (U+1E00 đến U+1EFF) encode thành chuỗi 3-byte UTF-8. Trình soạn thảo Windows đôi khi thêm byte-order mark khiến một số JSON parser xuất lỗi hoặc hiển thị ký tự sai. VS Code hiện encoding trong thanh trạng thái: chọn "UTF-8", không phải "UTF-8 with BOM".

Bạn tự làm được gì và khi nào nên dùng chuyên gia tiếng Việt?

Toàn bộ thiết lập kỹ thuật trên - cấu hình vue-i18n, Nuxt, hreflang và lazy-loading - là việc nội bộ. Các công cụ dịch máy như DeepL và Google Translate xử lý tốt các chuỗi UI tiếng Việt đơn giản.

Chuyên gia tiếng Việt bản ngữ nên được thuê khi:

  • Lựa chọn văn phong: Tiếng Việt có văn phong trang trọng (kính/quý khách) và thân mật (bạn). Sai văn phong trong ứng dụng fintech hoặc y tế làm giảm ngay niềm tin của người dùng Việt.
  • Thuật ngữ Hán-Việt: Từ vựng tài chính, pháp lý và y tế thường có hai từ tương đương - thuật ngữ Hán-Việt (trang trọng, kỹ thuật) và từ thuần Việt (gần gũi, dễ hiểu). Chọn lựa này là phán đoán văn hóa, không phải dịch thuật đơn thuần.
  • Chuỗi UI ngắn không có ngữ cảnh: Nhãn nút bấm và thông báo lỗi ngắn là điểm dịch máy thất bại nhất với tiếng Việt.

Một ngày review của chuyên gia tiếng Việt bản ngữ trên bản dịch máy thường tốn kém ít hơn nhiều so với dịch lại sau khi nhận phản hồi từ người dùng. Dịch vụ bản địa hóa website và ứng dụng tiếng Việt tại đây kết hợp kiểm tra kỹ thuật với QA thủ công cho dự án Vue và Nuxt.

Câu hỏi thường gặp

Nên dùng vi hay vi-VN làm mã locale trong vue-i18n?

Dùng vi trong cài đặt locale của vue-i18n và tên file (vi.json). Đặt language: 'vi-VN' trong mảng locales của Nuxt i18n để tạo BCP 47 hreflang tag. Hai cài đặt này phục vụ mục đích khác nhau: vue-i18n dùng để khớp message, còn Nuxt dùng để báo hiệu ngôn ngữ cho trình tìm kiếm.

Có cần thêm pluralizationRules cho tiếng Việt không?

Không. Tiếng Việt không có số nhiều ngữ pháp: Unicode CLDR chỉ gán category "other". Rule mặc định của Vue i18n trả về "other" cho mọi giá trị số, đúng hoàn toàn với tiếng Việt. Bỏ qua pluralizationRules và viết chuỗi message một dạng duy nhất.

Làm sao kiểm tra thẻ hreflang tiếng Việt có đúng không?

Build trang web và kiểm tra source HTML để tìm thẻ <link rel="alternate" hreflang="vi-VN">. Thuộc tính href phải là URL đầy đủ (https://...). Dùng công cụ URL Inspection trong Google Search Console để xác nhận Google đã phân tích hreflang sau khi deploy.

Chuỗi tiếng Việt hiển thị bị vỡ ký tự - nguyên nhân là gì?

Nguyên nhân phổ biến nhất là BOM trong file JSON locale. Kiểm tra thanh trạng thái VS Code: nếu hiện "UTF-8 with BOM" thì lưu lại dạng "UTF-8". Nguyên nhân khác: đọc file bằng PowerShell 5.x Get-Content mặc định dùng Windows-1252 làm hỏng ký tự đa byte tiếng Việt. Luôn dùng hàm fs của Node.js (readFileSync(path, 'utf8')) để đọc và ghi file locale.

Có thể dùng lại cùng file message vue-i18n trong cả Vue SPA và Nuxt không?

Có. Vue i18n là thư viện nền tảng cho cả hai. Format file JSON message, cú pháp nội suy và quy tắc số nhiều đều giống hệt nhau. Nuxt chỉ thêm routing, hreflang và lazy-loading. Nếu chuyển từ Vue SPA sang Nuxt, file locales/vi.json hiện có hoạt động mà không cần thay đổi.

Nguồn

Dao Huy (Lucas)
Dao Huy (Lucas)
Tốt nghiệp Trường Đại học Ngoại ngữ, Đại học Đà Nẵng. Ký cam kết chính xác trên mọi bản dịch có xác nhận (USCIS, IRCC).

Bài viết bởi Đào Huy (Lucas), biên dịch viên và chuyên viên bản địa hóa tiếng Việt (Anh, Trung, Pháp sang Việt). See translation services →

Báo giáWhatsApp