💡 Để bản địa hóa ứng dụng Angular sang tiếng Việt: cài
@angular/localize, đánh dấu chuỗi template với thuộc tínhi18n, chạyng extract-i18nđể tạo file XLIFFmessages.xlf, dịch sang tiếng Việt, khai báo localevitrongangular.jsonvà build vớing build --localize. Điểm đơn giản hóa quan trọng: tiếng Việt chỉ có một dạng số nhiều ICU, nên chuỗi số nhiều chỉ cần một nhánhotherduy nhất.
Ý chính
- Pipeline i18n tích hợp của Angular dùng biên dịch AOT: chuỗi đánh dấu với
i18nđược thay thế lúc build, tạo ra một bản build riêng cho mỗi locale mà không tốn overhead runtime. - Chạy
ng extract-i18n --output-path src/localeđể tạomessages.xlf. Sao chép và đổi tên thànhmessages.vi.xlf, rồi điền các phần tử<target>bằng tiếng Việt. - Tiếng Việt chỉ có một dạng số nhiều CLDR: other. File XLIFF tiếng Việt không bao giờ cần nhánh
one. Chỉ dùng selector chính xác=0và=1cho các trường hợp đặc biệt. - Đăng ký dữ liệu locale với
registerLocaleData(localeVi)và cung cấpLOCALE_ID: 'vi'. Các pipeDatePipe,CurrencyPipevàDecimalPipecủa Angular tự định dạng VND, ngày DD/MM/YYYY và dấu phân cách hàng nghìn bằng dấu chấm. - Chuỗi UI tiếng Việt dài hơn tiếng Anh 10-20%. Kiểm tra tất cả nhãn nút, tab điều hướng và viewport di động trước khi phát hành.
Pipeline i18n tích hợp của Angular hoạt động như thế nào?
Angular cung cấp toàn bộ pipeline quốc tế hóa trong package @angular/localize. Khác với các thư viện i18n runtime thay chuỗi trên trình duyệt, Angular biên dịch một bản build riêng cho mỗi locale. Angular CLI trích xuất chuỗi đánh dấu vào file XLIFF, hợp nhất XLIFF đã dịch lúc build, và xuất thư mục riêng cho từng ngôn ngữ.
Kết quả là triển khai thuần tĩnh: mỗi bản build locale chứa chính xác chuỗi cần thiết mà không có logic chuyển locale runtime. Thư mục vi/ có thể phục vụ từ CDN hoặc host tĩnh mà không cần phát hiện ngôn ngữ phía server.
Hướng dẫn i18n chính thức của Angular bao gồm toàn bộ pipeline từ thiết lập đến triển khai, bao gồm cách xử lý ID không khớp khi chuỗi nguồn thay đổi giữa các phiên bản.
Trích xuất file XLIFF và viết bản dịch tiếng Việt
Thêm package localize vào dự án:
ng add @angular/localize
Đánh dấu chuỗi trong template với thuộc tính i18n. Cung cấp metadata ý nghĩa và mô tả để hỗ trợ dịch viên:
<h1 i18n="site title|Homepage heading">My Product</h1>
<img i18n-title title="Company logo" alt="Company logo" />
Trích xuất tất cả chuỗi đánh dấu:
ng extract-i18n --output-path src/locale
Lệnh này tạo src/locale/messages.xlf. Sao chép thành src/locale/messages.vi.xlf và thêm phần tử <target> bằng tiếng Việt:
<trans-unit id="introductionHeader" datatype="html">
<source>My Product</source>
<target>Sản phẩm của tôi</target>
</trans-unit>
XLIFF 1.2 là định dạng mặc định. Dùng --format xlf2 cho XLIFF 2.0. Cả hai tương thích với CAT tool như Trados Studio, memoQ và Smartcat, nên bạn có thể gửi file trực tiếp cho dịch viên tiếng Việt mà không cần công cụ tùy chỉnh.
Chuỗi ICU plural trong tiếng Việt đơn giản hóa thế nào?
Tiếng Anh cần hai dạng số nhiều CLDR: one (số ít) và other. Tiếng Việt chỉ cần other. Tiếng Việt diễn đạt số lượng qua loại từ và ngữ cảnh, không qua biến hình từ, nên mọi con số đều ánh xạ đến cùng một dạng.
Chuỗi plural trong template tiếng Anh:
<span i18n>{count, plural, =0 {No results} one {# result} other {# results}}</span>
Trở thành trong messages.vi.xlf:
<target>{VAR_PLURAL, plural, =0 {Không có kết quả} other {# kết quả}}</target>
Tiếng Việt nói "1 kết quả" và "5 kết quả" với cùng một dạng từ. Chỉ cần selector chính xác =0 và =1 cho các trường hợp đặc biệt như trạng thái rỗng. Điều này làm giảm phạm vi dịch thuật cho mọi chuỗi liên quan đến số lượng trong ứng dụng.
Mệnh đề ICU select của Angular hoạt động bình thường. Tiếng Việt không thay đổi các từ xung quanh để khớp với giới tính ngữ pháp, nên các mệnh đề select dịch từng tùy chọn trực tiếp mà không cần điều chỉnh thêm.
Ngày tháng, số và tiền tệ tiếng Việt: các pipe Angular định dạng thế nào?
Đăng ký dữ liệu locale tiếng Việt trong app.config.ts trước khi các pipe hoạt động đúng:
import { registerLocaleData } from '@angular/common';
import localeVi from '@angular/common/locales/vi';
registerLocaleData(localeVi, 'vi');
// Trong providers:
{ provide: LOCALE_ID, useValue: 'vi' }
Với locale vi đang hoạt động, các pipe của Angular tạo kết quả tiếng Việt chính xác:
- DatePipe:
{{ today | date:'shortDate' }}trả về14/11/2026(DD/MM/YYYY). Định dạng dài dùng tên tháng tiếng Việt. - DecimalPipe:
{{ 1500000 | number }}trả về1.500.000. Dấu chấm là dấu phân cách hàng nghìn; dấu phẩy là dấu thập phân trong tiếng Việt. - CurrencyPipe:
{{ 250000 | currency:'VND' }}trả về250.000 ₫. VND không có đơn vị thập phân. - PercentPipe:
{{ 0.65 | percent }}trả về65%. Tiếng Việt không dùng khoảng cách đặc biệt với ký hiệu phần trăm.
Các quy tắc định dạng này đến từ dự án Unicode CLDR, chuẩn chính thức cho quy tắc định dạng theo locale. Angular đóng gói dữ liệu CLDR cho vi trong @angular/common/locales/vi.
Build locale vi và kiểm tra bố cục tiếng Việt
Khai báo locale tiếng Việt trong angular.json tại khóa i18n của dự án, rồi build với ng build --localize:
"i18n": {
"sourceLocale": "en-US",
"locales": {
"vi": { "translation": "src/locale/messages.vi.xlf" }
}
}
CLI xuất ra dist/my-app/vi/ và tự điều chỉnh base href. Thêm cấu hình có tên để build riêng tiếng Việt: ng build --configuration=production,vi. Phục vụ từng locale từ thư mục con (/vi/) và cấu hình server hoặc CDN chuyển hướng theo Accept-Language.
Trước khi phát hành, chạy danh sách kiểm tra bố cục này với bản build tiếng Việt:
- Kiểm tra tất cả nhãn nút và CTA ở viewport di động 375px và 390px. Cụm danh từ tiếng Việt mở rộng hơn so với khi tiếng Anh dùng động từ ngắn.
- Kiểm tra tab, breadcrumb và tùy chọn dropdown. Danh từ tiếng Việt thường đa âm tiết trong khi tiếng Anh dùng từ đơn hoặc viết tắt.
- Xác minh hỗ trợ font: tiếng Việt dùng dấu phụ kết hợp qua sáu dấu thanh và các biến thể móc/lưỡi liềm trên nguyên âm cơ sở. Kiểm tra hiển thị ký tự như ộ, ề, ầ, ắ, ự, ẫ trong mọi web font bạn tải. Font hệ thống trên Android, iOS, Windows và macOS hỗ trợ đầy đủ; bộ font web rút gọn có thể thiếu glyph tiếng Việt.
- Angular tự thiết lập
lang="vi"trên phần tử<html>khi locale được cấu hình đúng. Áp dụng thêmoverflow-wrap: break-wordtrong CSS để xử lý thuật ngữ kỹ thuật dài trong container hẹp.
Tự làm hay thuê chuyên gia: ranh giới thực tế cho team Angular hướng đến Việt Nam
Công việc kỹ thuật - cài @angular/localize, đánh dấu chuỗi, chạy extraction, cấu hình angular.json - hoàn toàn có thể tự làm. Bất kỳ lập trình viên nào quen Angular CLI đều có thể hoàn thành thiết lập trong một ngày. Dịch máy xử lý tốt với khối lượng lớn chuỗi có cấu trúc: nhãn form, thông báo lỗi, tooltip và tài liệu trợ giúp.
Chuyên gia người Việt bản địa thực sự tạo ra giá trị ở: giọng điệu UI sản phẩm, nội dung marketing và từ vựng chuyên ngành. Tiếng Việt phân biệt văn phong trang trọng và thân mật, và sự lựa chọn này ảnh hưởng đến cảm giác chuyên nghiệp của sản phẩm đối với người dùng doanh nghiệp. Từ Hán-Việt (từ vựng có nguồn gốc từ tiếng Hán cổ điển) thể hiện chuyên môn trong tài chính, y tế và pháp luật - máy dịch thông thường mặc định dùng từ thuần Việt đơn giản hơn mà người review chuyên nghiệp đánh giá là chưa chính xác.
Cách phân chia thực tế cho hầu hết team Angular: dùng MT kết hợp post-editing cho phần lớn nội dung trợ giúp và thông báo lỗi, và thuê chuyên gia cho 50-100 chuỗi người dùng đọc mỗi phiên làm việc. Với sản phẩm B2B mà nhóm mua hàng Việt Nam sẽ đánh giá giao diện, hãy dự trù review toàn bộ bởi người bản ngữ trước khi ra mắt.
Với dịch thuật chuyên nghiệp Anh-Việt cho ứng dụng Angular và phần mềm B2B, dịch vụ bản địa hóa website tiếng Việt trên trang này xử lý cả dịch thuật và review kỹ thuật file XLIFF.
Câu hỏi thường gặp
Có thể dùng Trados, memoQ hay Smartcat để dịch file XLIFF của Angular không?
Được. XLIFF 1.2 (.xlf) là chuẩn mở được hỗ trợ bởi tất cả CAT tool lớn như Trados Studio, memoQ, Smartcat và Lokalise. Gửi trực tiếp file messages.vi.xlf cho dịch viên. Lưu ý dịch viên không được sửa thuộc tính id hay phần tử placeholder như <x id="INTERPOLATION"/>. Một số tool có bộ lọc XLIFF dành riêng cho Angular tự xử lý các placeholder này.
Sự khác biệt giữa XLIFF 1.2 và XLIFF 2.0 cho dự án tiếng Việt là gì?
Angular tạo XLIFF 1.2 theo mặc định (.xlf). Dùng ng extract-i18n --format xlf2 cho XLIFF 2.0 (.xlf2). XLIFF 2.0 có schema gọn hơn và hỗ trợ namespace tốt hơn. Sự khác biệt thực tế cho tiếng Việt là nhỏ: chọn định dạng mà CAT tool hoặc agency dịch thuật của bạn ưa thích. Cả hai đều hỗ trợ cú pháp ICU MessageFormat dùng trong Angular template.
Nên dùng 'vi' hay 'vi-VN' làm locale ID trong Angular?
Dùng vi. Angular có dữ liệu locale cho cả vi và vi-VN trong @angular/common/locales/, nhưng vi là thẻ BCP 47 chính và bao gồm tất cả người dùng tiếng Việt. Theo hướng dẫn thẻ ngôn ngữ của W3C, hãy dùng thẻ ngắn nhất xác định chính xác ngôn ngữ trừ khi cần phân biệt biến thể vùng. Dùng vi-VN chỉ khi thư viện bên thứ ba yêu cầu mã locale đầy đủ.
Làm sao test bản build tiếng Việt khi phát triển cục bộ?
Thêm cấu hình build có tên vi vào angular.json, rồi chạy ng serve --configuration=vi. Dev server phục vụ locale tiếng Việt theo đường dẫn đã cấu hình. Để kiểm tra tất cả locale đồng thời, chạy ng build --localize và dùng server tĩnh cục bộ để phục vụ thư mục dist/. Lệnh ng serve không hỗ trợ build nhiều locale runtime; dùng cách build-rồi-serve cho kiểm tra trước khi phát hành.
Điều gì xảy ra với chuỗi tiếng Việt khi chuỗi nguồn thay đổi sau khi extraction?
Khi chuỗi nguồn đã đánh dấu thay đổi, Angular tạo ID translation unit mới. ID cũ trong messages.vi.xlf trở thành không dùng, và ID mới chưa có <target>. Angular build sẽ cảnh báo về translation bị thiếu. Thêm ID tùy chỉnh với @@my-id: i18n="@@product-title". Điều này cho phép cập nhật chuỗi nguồn mà không làm mất bản dịch tiếng Việt, miễn là ý nghĩa ngữ nghĩa không thay đổi.
Nguồn tham khảo
- Tài liệu Angular: Quốc tế hóa - Tổng quan pipeline i18n, đánh dấu văn bản với thuộc tính i18n, ICU messages, trích xuất và hợp nhất XLIFF. Đã xác minh tháng 11 năm 2026.
- Tài liệu Angular: Hợp nhất bản dịch vào ứng dụng - Cấu hình locale trong angular.json, lệnh ng build --localize, mẫu triển khai thư mục con. Đã xác minh tháng 11 năm 2026.
- Unicode CLDR (Common Locale Data Repository) - Dữ liệu định dạng locale chính thức cho ngày tháng, số và tiền tệ tiếng Việt (locale vi). Đã xác minh tháng 11 năm 2026.
- W3C Quốc tế hóa: Thẻ ngôn ngữ trong HTML và XML - Hướng dẫn BCP 47 về vi so với vi-VN và cách dùng thuộc tính lang đúng. Đã 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 →
