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

Angular应用越南语本地化:XLIFF工作流与locale格式配置

将Angular应用本地化为越南语:提取XLIFF文件,在angular.json配置vi locale,用Angular管道正确格式化越南盾和DD/MM/YYYY日期。

Dao Huy (Lucas)8分钟8 节
Angular应用越南语本地化:XLIFF工作流与locale格式配置

💡 将Angular应用本地化为越南语:安装@angular/localize,使用i18n属性标记模板字符串,运行ng extract-i18n生成XLIFF文件messages.xlf,翻译为越南语,在angular.json中声明vi locale,然后用ng build --localize构建。关键简化:越南语只有一个ICU复数类别,所有复数字符串只需一个other分支。

要点

  • Angular内置i18n管道使用AOT编译:标记了i18n的字符串在构建时被替换,每个locale生成一个语言专属构建版本,无运行时开销。
  • 运行ng extract-i18n --output-path src/locale生成messages.xlf,复制并重命名为messages.vi.xlf,然后用越南语填写<target>元素。
  • 越南语只有一个CLDR复数类别:other。越南语XLIFF文件永远不需要one分支,只在特定零值/单值边界情况时使用=0和=1精确选择器。
  • 使用registerLocaleData(localeVi)注册locale数据,提供LOCALE_ID: 'vi'。Angular的DatePipe、CurrencyPipe和DecimalPipe自动格式化VND货币、DD/MM/YYYY日期和点号千位分隔符。
  • 越南语UI字符串通常比英语长10-20%。首次发布前测试所有按钮标签、导航选项卡和移动端视口。

Angular内置i18n系统是如何工作的?

Angular在@angular/localize包中内置了完整的国际化管道。与在浏览器中运行时替换字符串的i18n库不同,Angular为每个locale编译独立的构建版本。Angular CLI将标记的字符串提取到XLIFF文件中,在构建时合并已翻译的XLIFF,并为每种语言输出独立的locale目录。

结果是纯静态部署:每个locale构建包含所需的确切字符串,无需运行时语言切换逻辑。对于进入越南市场的中国企业,vi/子目录可以从CDN或静态主机提供服务,无需服务端语言检测。

Angular官方i18n指南涵盖从设置到部署的完整管道,包括如何处理版本间源字符串变更导致的ID不匹配问题。

提取XLIFF文件并撰写越南语翻译

向项目添加localize包:

ng add @angular/localize

在模板中使用i18n属性标记字符串。提供意义和描述元数据以帮助译员:

<h1 i18n="site title|Homepage heading">My Product</h1>
<img i18n-title title="Company logo" alt="Company logo" />

提取所有标记的字符串:

ng extract-i18n --output-path src/locale

这会创建src/locale/messages.xlf。复制为src/locale/messages.vi.xlf并添加越南语<target>元素:

<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是默认格式,使用--format xlf2切换到XLIFF 2.0。两种格式均兼容Trados Studio、memoQ和Smartcat等CAT工具,可直接将文件发送给越南语译员,无需定制工具。

越南语没有复数变形时,ICU复数消息如何简化?

英语需要两个CLDR复数类别:one(单数)和other。越南语只需要other。越南语通过量词和语境表达数量,不通过词尾变化,因此所有数字映射到同一形式。这与中文的复数规则相似:中文同样只有一个other类别。

英语模板复数字符串:

<span i18n>{count, plural, =0 {No results} one {# result} other {# results}}</span>

在messages.vi.xlf中变为:

<target>{VAR_PLURAL, plural, =0 {Không có kết quả} other {# kết quả}}</target>

越南语说"1 kết quả"和"5 kết quả"使用相同词形。只有=0和=1精确选择器用于空状态等特殊边界情况。这一简化减少了应用中所有数量相关字符串的翻译工作量。

越南语日期、数字和货币:Angular管道如何格式化?

在app.config.ts中注册越南语locale数据,之后管道才能正确格式化:

import { registerLocaleData } from '@angular/common';
import localeVi from '@angular/common/locales/vi';
registerLocaleData(localeVi, 'vi');

// 在providers中:
{ provide: LOCALE_ID, useValue: 'vi' }

激活vi locale后,Angular管道产生正确的越南语输出:

  • DatePipe:{{ today | date:'shortDate' }}返回14/11/2026(DD/MM/YYYY格式)。长格式使用越南语月份名称。
  • DecimalPipe:{{ 1500000 | number }}返回1.500.000。句点为千位分隔符,逗号为小数分隔符。
  • CurrencyPipe:{{ 250000 | currency:'VND' }}返回250.000 ₫。越南盾无小数位。
  • PercentPipe:{{ 0.65 | percent }}返回65%。越南语百分号无特殊间距。

这些格式化规则来自Unicode CLDR项目,该项目是locale专属格式化规则的权威标准。Angular将vi locale的CLDR数据打包在@angular/common/locales/vi中。

配置vi locale构建并测试越南语界面

在angular.json的项目i18n键下声明越南语locale,然后运行ng build --localize:

"i18n": {
  "sourceLocale": "en-US",
  "locales": {
    "vi": { "translation": "src/locale/messages.vi.xlf" }
  }
}

CLI输出dist/my-app/vi/并自动调整base href。添加命名配置以独立构建越南语版本:ng build --configuration=production,vi。从各自的子目录(/vi/)提供每个locale服务,并配置Web服务器或CDN根据Accept-Language请求头进行重定向。

发布前,对越南语构建版本执行以下界面检查:

  • 在375px和390px移动端视口测试所有按钮和CTA标签。越南语复合名词短语比英语短动词更长。
  • 检查选项卡、面包屑和下拉选项。越南语名词通常是多音节词,而英语使用单个词或缩写。
  • 验证字体覆盖:越南语使用六个声调符号加基本元音上的钩形/弧形修饰组合变音符。确认每个加载的Web字体能正确渲染ộ、ề、ầ、ắ、ự、ẫ等字符。Android、iOS、Windows和macOS的系统字体默认支持;精简版Web字体子集可能缺少越南语字形。
  • Angular正确配置locale后会自动在根<html>元素上设置lang="vi"。在CSS中应用overflow-wrap: break-word以防止技术术语在窄容器中溢出。

内部处理还是聘请专家:中国团队进入越南市场的实际分界线

工程工作:安装@angular/localize、标记字符串、运行提取命令、配置angular.json,完全可以在内部完成。熟悉Angular CLI的开发人员一天内即可完成配置。对于大量结构化字符串(表单标签、错误消息、工具提示和帮助文档),机器翻译配合审校效果良好。

越南本地专家真正体现价值的地方:产品UI语气、营销文案和领域专业术语。汉越词(源自古汉语的词汇)在金融、医疗和法律产品中传达专业信号,这一点对进入越南市场的中国公司尤为有利:中越两种语言共享大量词汇基础,但发音和用法有所不同,专业译员能精准把握这些细微差别。通用机器翻译引擎通常选择更简单的纯越南语对应词,专业审校人员认为这不够精确。

大多数进入越南市场团队的实际分工:对帮助内容和错误消息的长尾使用机器翻译配合后期编辑,对用户每次会话都会看到的50-100个字符串聘请人工专家。如需专业的中文到越南语Angular Web应用翻译,本站的越南语网站本地化服务提供翻译和XLIFF文件技术审校服务,支持中文、英文和法文源语言。

常见问题

可以用Trados、memoQ或Smartcat翻译Angular XLIFF文件吗?

可以。XLIFF 1.2(.xlf)是开放标准,受Trados Studio、memoQ、Smartcat和Lokalise等所有主流CAT工具支持。直接将messages.vi.xlf文件发送给译员。提醒译员不得修改id属性或<x id="INTERPOLATION"/>等占位符元素。部分工具提供Angular专用的XLIFF过滤器,可自动处理这些占位符。

XLIFF 1.2和XLIFF 2.0对越南语项目有何区别?

Angular默认生成XLIFF 1.2(.xlf)。使用ng extract-i18n --format xlf2生成XLIFF 2.0(.xlf2)。XLIFF 2.0具有更简洁的schema和更好的命名空间支持。对越南语而言,实际差异很小:选择您的CAT工具或翻译机构偏好的格式即可。两种格式都支持Angular模板中使用的ICU MessageFormat语法。

Angular中应使用'vi'还是'vi-VN'作为locale ID?

使用vi。Angular在@angular/common/locales/中同时提供vi和vi-VN的locale数据,但vi是BCP 47主标签,涵盖所有越南语用户。根据W3C语言标签指南,除非需要区分地区变体,否则使用最短的标签。仅当第三方库需要完整locale代码进行数据查找时才使用vi-VN。

如何在本地开发中测试越南语构建?

在angular.json中添加名为vi的构建配置,然后运行ng serve --configuration=vi。开发服务器在配置的路径上提供越南语locale服务。要同时测试所有locale,运行ng build --localize并使用本地静态服务器提供dist/输出。ng serve命令不支持运行时多locale构建;对最终发布前检查使用构建后服务的方式。

源文本在提取后更改会如何影响越南语字符串?

当标记的源字符串更改时,Angular生成新的翻译单元ID。messages.vi.xlf中的旧ID变为未使用,新ID没有<target>元素。Angular构建会警告缺少翻译。使用@@my-id添加自定义ID来控制ID稳定性:i18n="@@product-title"。这样可以在语义不变的情况下更新源字符串而不会使越南语翻译失效。

参考来源

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

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

报价WhatsApp