💡 Tóm tắt: Thêmvilàm locale trong vue-i18n và đặtlanguage: '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ùnguseLocaleHead()trong layout gốc để tự động tạo thẻ hreflang cho Google.
Ý chính
- Dùng
vitrong vue-i18n; đặtlanguage: '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
- Vue i18n: Pluralization - tài liệu chính thức về quy tắc chọn message và pluralizationRules. Xác minh tháng 11 năm 2026.
- Nuxt i18n: SEO - composable useLocaleHead(), tạo hreflang và cấu hình baseUrl. Xác minh tháng 11 năm 2026.
- Nuxt i18n: Lazy-load translations - tải locale dựa trên file và chiến lược cache. Xác minh tháng 11 năm 2026.
- W3C Internationalization: Choosing a language tag - hướng dẫn BCP 47 bao gồm vi và vi-VN. Xác minh tháng 11 năm 2026.
- Unicode CLDR: Language Plural Rules - phân loại danh mục "other" của tiếng Việt. Xác minh tháng 11 năm 2026.

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 →
