💡 为UE5游戏添加越南语,技术设置约需半天:打开本地化仪表板,添加文化代码vi,用NSLOCTEXT标记玩家可见字符串,导出PO文件给译者,导入后编译生成LocRes。越南语有两个特殊难点:字体须覆盖全部变音符范围,以及用户输入须进行NFC规范化。两者均有成熟解决方案。
要点
- 打开Tools > Localization Dashboard,在Cultures中添加文化代码
vi,并设置原生文化(通常为en)。 - 在C++中用
NSLOCTEXT("NS","Key","Source")标记所有玩家可见字符串,或在Blueprint中使用String Table资源。 - 导出PO文件,用Poedit或CAT工具翻译,重新导入后点击Compile生成LocRes,再进行打包。
- 使用覆盖Latin Extended Additional(U+1E00-U+1EFF)的字体:Noto Sans、Source Sans 3或Roboto在UE5中均可正常使用。
- 将来自用户输入的越南语文本规范化为NFC后再存储或比较,不同输入法对同一字符产生不同的Unicode编码序列。
越南游戏市场值得本地化的理由
越南2025年初的互联网用户达7980万,活跃移动连接超过1.27亿,远超约1亿的总人口数(来源:DataReportal 2025年越南数字报告)。越南是典型的移动优先市场,游戏是Android和iOS平台使用时长最高的类别之一。目前进入越南市场的大多数游戏仍以英语或简体中文提供,越南语本地化版本相对稀缺。率先提供越南语版本的游戏在留存率和内购转化率方面都具有明显优势。
从语言学角度看,越南语没有语法性别,名词也不随数量变形,这使得翻译成本低于法语或德语等曲折语言。主要技术挑战集中在字体选择和Unicode规范化两个方面,本指南将详细说明。
在本地化仪表板中添加越南语
在UE5编辑器中,打开Tools > Localization Dashboard。如果尚无本地化目标,点击Add New Target并命名(通常为"Game")。在Cultures标签页中,点击+并输入vi,这是越南语的BCP 47语言标签。区域子标签vi-VN在技术上合法,但除非需要为海外越南社区提供区域专属版本,否则没有实际意义。将源语言设置为Native文化。
在Gather部分,将采集器指向源代码和内容目录,运行Gather Text。这将把所有NSLOCTEXT宏、Blueprint文本引脚和String Table扫描进manifest文件。然后使用Export为vi文化生成.po文件,发送给译者。收到翻译后,用Import将PO文件加载回archive,运行Compile生成.locres和.locmeta运行时文件。在最终打包前,在Project Settings > Packaging > Localizations to Package中启用vi。
哪些字符串需要NSLOCTEXT,哪些不需要?
玩家在游戏中读到的所有文字都应使用NSLOCTEXT或LOCTEXT创建的FText,包括按钮标签、NPC对话、教程文本、错误消息、提示描述、成就名称和任务目标。String Table提供数据驱动的替代方案:创建ST_Game.csv资源,用LOCTABLE引用各行。Blueprint的文本引脚自动包装FText,无需额外处理即可被采集。
不应本地化的字符串包括:调试日志消息、服务器API密钥和端点路径、分析事件名称、资源引用路径,以及任何不会显示给玩家的字符串。对这些使用INVTEXT或普通FString。将内部标识符误标为NSLOCTEXT只会让manifest膨胀,给译者审查数千条字符串时造成干扰。
越南语UI文本比英语更长吗?
越南语字符串的词数通常与英语接近,但每个字符都带有叠加变音符。像ộ(o加帽形符加下点)这样的单个字符渲染高度超过普通ASCII字母。因此,越南语文本需要比无变音符的拉丁文本多约10-20%的行高。按英语标签尺寸设计的按钮可能在顶部和底部裁切越南语文本,而非两侧。
建议在UI布局最终定稿前用真实越南语字符串测试最受限的界面元素。快速估算技巧:在英语单词末尾加"g"或"y"来近似垂直溢出风险。在行长方面,越南语通常与英语相当,因为较短的越南语单词补偿了变音符带来的开销。越南语的UI风险是垂直方向,不是水平方向。
UE5中支持越南语变音符的字体选择
越南语字符分布在多个Unicode块中:基本拉丁字母(U+0041-U+007A)、Latin Extended Additional(U+1E00-U+1EFF)和组合变音符(U+0300-U+036F)。字体必须包含完整的Latin Extended Additional块才能渲染所有声调符号和元音组合。缺失字形在游戏中显示为方块或问号。
在UE5中经测试可正常导入使用的字体包括Noto Sans、Source Sans 3和Roboto,均可从fonts.google.com获取。将.ttf文件作为Font Face资源导入,创建Font资源,并分配给Slate或UMG文本样式。如果现有游戏字体不支持越南语,可在UE5中设置Composite Font,将支持越南语的字体添加为U+1E00-U+1EFF范围的回退字体。引擎将按字符混合使用两种字体:品牌字体处理基本拉丁字符,回退字体覆盖越南语变音符。
哪些工作可以内部完成,何时需要越南语本地化专家?
本指南中的全部技术工作均可由技术团队内部完成,无需外部支持:仪表板设置、PO导出导入、字体选择、NFC规范化,以及使用-culture=vi测试。DeepL和Google Translate等机器翻译工具可为简单UI字符串(按钮标签、菜单项、上下文清晰的系统消息)生成可用的初稿。
以下情况值得引入越南语母语专家:
- 游戏剧情和对话:机器翻译的NPC台词听起来平淡或生硬,立即破坏沉浸感。
- 应用商店元数据:标题、简短描述和完整描述是第一印象,直接影响在越南Google Play和App Store的可见度。
- 文化特定的名字和梗:越南玩家能立即察觉角色名在越南语中是否有意外含义,或笑点使用了不恰当的语域。
- 南北方语言差异:标准书面越南语全国通行,但某些词汇选择(如南方说"xe may",北方说"xe gan may")会让母语读者察觉出地域来源。
机器翻译初稿完成后,由越南语游戏本地化母语专家进行一轮审校,即可以远低于全量翻译的成本解决上述大多数问题。
Unreal Engine中越南语应使用哪个文化代码?
使用BCP 47语言标签vi。区域子标签vi-VN(越南地区)在技术上合法,但除非计划为海外越南社区(如美国越南裔)提供区域专属构建版本,否则没有实际区别。
可以用DeepL或Google Translate自动生成越南语PO文件吗?
机器翻译可以较好地处理上下文清晰的短字符串,如按钮标签和菜单项。处理较长对话、习惯用语和文化特定内容时效果较差。建议将机器翻译作为UI字符串的初稿,然后由越南语母语者在发布前审查对话、营销文本和商店元数据。
北部和南部越南玩家需要分开本地化吗?
不需要。标准书面越南语全国通行。口语方言在词汇和发音上有所不同,但发布的游戏均使用标准书面形式。唯一例外是配音:河内口音(北部)和胡志明市口音(南部)均可接受,但选择其中一种可能会影响另一地区受众的感受。
如何在没有越南语QA团队的情况下测试越南语本地化?
使用命令行标志-culture=vi强制游戏以越南语运行,或在本地化仪表板中更改预览文化。检查被截断的文本、以方块显示的缺失字体字形,以及布局溢出问题。在全面QA前,请母语者审查部分字符串样本,尤其是对话和商店元数据。
如何处理玩家输入的越南语文本,例如用户名或聊天内容?
将玩家输入的越南语文本存储或显示前规范化为Unicode NFC。越南语输入法根据使用的方法对同一字符产生不同的码点序列。如不进行规范化,两名输入相同用户名的玩家可能产生在搜索或好友系统中比较不相等的字符串。
参考来源
- Unreal Engine Localization Overview - 文件格式(manifest、archive、PO、LocRes、LocMeta)、工作流程、ICU库。已验证,2026年11月。
- Unreal Engine Text Localization - FText、NSLOCTEXT、格式修饰符、String Table。已验证,2026年11月。
- W3C:Unicode迁移与越南语规范化 - 越南语输入规范化与NFC要求。已验证,2026年11月。
- DataReportal:2025年越南数字报告 - 7980万互联网用户,1.27亿移动连接。已验证,2026年11月。
作者:Đào Huy(Lucas),越南语译员与本地化专家(英、中、法译越)。 See translation services →

