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

iOS应用越南语本地化：Xcode配置与App Store元数据指南

将iOS应用本地化为越南语：在Xcode中添加vi代码，使用String Catalogs自动同步，处理单一CLDR复数类别，填写完整App Store Connect越南语元数据。

Dao Huy (Lucas)7分钟8 节
iOS应用越南语本地化：Xcode配置与App Store元数据指南

💡 要将iOS应用本地化为越南语：在Xcode项目设置中添加vi语言代码，使用String Catalogs(.xcstrings)自动追踪字符串，每个字符串只需编写一个复数分支（越南语只有一个CLDR复数类别），本地化Info.plist权限说明文字，并在提交前在App Store Connect中填写完整的越南语元数据。越南语字符串通常比英语长10-20%，发布前请测试界面布局。

要点

  • 在Xcode项目设置 > Localizations中添加越南语(vi)，Xcode会为每个本地化资源自动创建vi.lproj/文件夹。
  • Xcode 27中的String Catalogs(.xcstrings)在每次构建后自动与SwiftUI和UIKit代码同步，无需手动维护.strings文件。
  • 越南语只有一个CLDR复数类别：other。.stringsdict和String Catalog中的复数规则只需一个越南语分支即可。
  • App Store Connect元数据限制：应用名称30字符，副标题30字符，简介4,000字符，关键词100字符。带变音符的越南语字符（ắ、ề、ộ）各计1个字符。
  • Info.plist权限说明字符串（NSCameraUsageDescription等）必须有越南语版本，iOS系统权限对话框会直接显示这些内容，App Review也会检查。

iOS应用越南语本地化需要哪些工作？

iOS越南语本地化涵盖四个独立层面：代码级字符串提取（NSLocalizedString / String(localized:)）、复数规则（stringsdict或String Catalog复数变体）、资源本地化（图像、故事板、Info.plist），以及App Store产品页面元数据。在应用面向越南市场上线之前，这四个层面都必须完整。

要添加越南语，在Xcode中打开.xcodeproj，在Info标签页的Localizations部分点击+，选择Vietnamese (vi)。Xcode会在bundle中为每个本地化资源创建vi.lproj/文件夹，对于使用String Catalogs的SwiftUI项目，下次构建后会自动收集越南语字符串。越南语的语言标识符是vi，除非第三方SDK要求完整locale代码，否则无需使用vi-VN。

Xcode 27中String Catalogs如何处理越南语复数规则？

String Catalogs (.xcstrings)是Xcode 16起针对新项目的推荐方案。该文件是一个结构化JSON文档，将所有翻译变体、复数规则和设备特定文本集中管理。添加越南语并构建后，Xcode自动扫描SwiftUI视图和UIKit调用，收集可本地化字符串并添加到catalog中，无需手动提取步骤。

越南语只有一个CLDR复数类别：other。所有数字，1、2、100，都映射到相同的词形。越南语通过量词和语境传达数量，而非形态变化。"1 mục"和"5 mục"（1个和5个条目）形式完全相同。

在String Catalog中，越南语复数槽只显示一个分支：other。对于旧版.stringsdict文件，越南语部分只需定义other键。当需要特定空状态消息时，使用=0精确匹配键，例如"Không có mục nào"（没有条目）。

<!-- 越南语.stringsdict示例（单一复数分支） -->
<key>item_count</key>
<dict>
  <key>NSStringLocalizedFormatKey</key>
  <string>%#@item_count@</string>
  <key>item_count</key>
  <dict>
    <key>NSStringPluralRuleType</key>
    <string>other</string>
    <key>other</key>
    <string>%d mục</string>
  </dict>
</dict>

如何将Info.plist权限说明本地化为越南语？

iOS权限对话框会原文显示使用说明字符串。如果这些字符串保持英文，越南用户会在iOS系统弹窗中看到英文内容，显得不完整，可能导致App Review以本地化不完整为由拒绝审核。

使用String Catalogs（Xcode 16+），创建或打开InfoPlist.xcstrings。Xcode会自动收集已识别的键：NSCameraUsageDescription、NSMicrophoneUsageDescription、NSLocationWhenInUseUsageDescription、NSPhotoLibraryUsageDescription等。为应用使用的每个键添加越南语翻译。

示例越南语说明："NSCameraUsageDescription" = "Ứng dụng cần truy cập camera để chụp ảnh hồ sơ của bạn.";

请具体说明为什么需要该权限。Apple审核和越南用户都希望看到明确的理由，含糊的说明可能引发审核问题。

App Store Connect中必须填写哪些越南语元数据？

Apple不会自动向越南用户显示英文产品页面。在App Store Connect的App Information > Localizations中添加Vietnamese (vi)本地化，然后填写以下字段：

  • 应用名称：最多30个字符。带变音符的越南语字符各计1个字符。"Quản lý tài chính"为18个字符，完全在限制内。
  • 副标题：最多30个字符。显示在搜索结果中应用名称下方。使用1-2个简短的越南语利益点短语。
  • 简介：最多4,000个字符。在App Store中"更多"折叠前显示的前三行（约255个字符）最为重要，请在此处放置最强的价值主张。
  • 关键词：总计最多100个字符，用逗号分隔，逗号周围无空格。越南用户快速搜索时常省略声调，考虑同时包含带声调和不带声调的关键词版本。
  • 截图：上传显示越南语界面的截图。App Review会检查截图与提交的本地化语言是否匹配。

越南语iOS布局会出现哪些问题，如何解决？

iOS系统字体（San Francisco、Helvetica Neue）能正确渲染越南语。问题主要出现在自定义字体和固定宽度标签约束上。

  • 自定义字体：验证字体包含所有越南语基本字母变体（ă、â、ê、ô、ơ、ư、đ）及完整的组合声调符号。缺失的字形会静默回退到系统字体，导致同一单词内出现混合字体渲染。测试字符串"ắ ề ộ ừ ẫ"是否正确显示。
  • 标签截断：越南语字符串比英语长10-20%。设置numberOfLines = 1且lineBreakMode = .byTruncatingTail的UILabel会截断英语版本能容纳的越南语文本。在iOS Simulator中运行越南语方案，以iPhone SE（375pt）宽度检查所有主要标签。
  • NFC规范化：越南语变音符可编码为预合成NFC（单一码点）或分解NFD（基本字符加组合标记）。两者渲染相同但NFD会导致字符串相等检查失败。在Swift中使用string.precomposedStringWithCanonicalMapping将字符串规范化为NFC。
  • 文本方向：越南语从左到右书写，不需要RTL处理。

内部处理还是聘请专家：iOS团队的真实分界线

工程工作，包括在Xcode中添加vi、配置String Catalogs、本地化Info.plist以及设置App Store Connect，完全可以内部完成，通常需要一到两个开发日。

机器翻译适用于功能性字符串：表单标签、错误消息、设置界面。这些字符串短小、结构化，机器翻译质量足以满足首次发布需求。

越南语本地专家真正节省成本的地方：App Store产品页面文案、引导流程以及专业术语。金融和医疗应用中需要使用汉越词汇（Hán Việt术语）："giao dịch"表示交易，"tài khoản"表示账户，"xác thực"表示验证。本地翻译师一次就能准确使用这些术语；机器翻译往往返回纯越南语对应词，对专业用户来说显得不够精准。

实用分工：对所有功能性字符串使用机器翻译，对App Store产品页面和用户每次会话都会看到的20-30个核心界面聘请越南语本地专家。如需为iOS应用提供专业的中越翻译服务，本站的越南语网站与应用本地化服务涵盖技术字符串翻译和App Store文案审校。

常见问题

Xcode中越南语的语言标识符是什么？

使用vi作为语言标识符。Xcode会在bundle中创建vi.lproj/文件夹。根据BCP 47，vi标签涵盖所有越南语用户。只有在第三方SDK需要完整locale代码进行数据查找时才使用vi-VN；在Xcode和App Store Connect中，短格式vi是正确的。

越南语复数规则需要.stringsdict文件吗？

只有旧版（非String Catalog）项目才需要。越南语只有一个CLDR复数类别(other)，因此越南语.stringsdict复数条目只需要other键。对于使用Xcode 16+的项目，改用String Catalogs(.xcstrings)，同样只需要单分支结构。新项目可以完全跳过.stringsdict。

越南语字符如何影响App Store关键词预算？

App Store Connect的关键词字段允许100个字符。越南语变音字符各计1个字符。100字符预算约可容纳8-12个有意义的越南语关键词短语。用逗号分隔，无空格。考虑到很多越南用户快速搜索时会省略声调，可以同时包含带声调和不带声调的版本（如果预算允许）。

中文应用进入越南市场时，越南语本地化有哪些特殊考量？

中文应用进入越南市场有独特优势：越南语中大量使用汉越词汇（Hán Việt），与中文同源词往往非常相似。例如"tài chính"（财政）、"giao dịch"（交易）、"công ty"（公司）这些词对中文背景团队来说很容易理解。然而，纯粹的文字对应往往行不通，越南语的日常表达和现代用法有其独特性，建议聘请越南本地校对审查所有面向用户的文本。

是否应该针对越南语的三种方言分别本地化？

对大多数应用而言，一个面向北部（河内）标准越南语的本地化版本已经足够。北部越南语是全国性媒体、正式文件和数字产品使用的标准变体。南部越南语（胡志明市）主要在几十个日常词汇上有所不同，语法和书写系统基本一致。对于一般消费者或B2B应用，标准越南语覆盖所有用户。

参考来源

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

作者：Đào Huy（Lucas），越南语译员与本地化专家（英、中、法译越）。 See translation services →

报价WhatsApp