产品文案要具备本地化条件,先得有单一来源:散落在各个组件里的字面量文案,靠重写无法使其具备本地化条件,因为根本没有一个公认的源文本可供翻译。清晰度、术语表和风格指南都很重要,但只有字符串集中到同一个目录之后,它们才有回报。本文讲的就是这套行之有效的操作顺序。

这个话题上的大多数建议是从第二步开始讲的:用平实的语言写作,避免习语,给译者提供上下文。这些都是好建议,但当同一条消息在各个组件里以五种略有差异的写法存在时,没有一条能真正落地。关于背景定义,以及为什么代码库应当成为产品文案的事实来源,请参阅代码原生的产品文案。本文讲的是实际的操作顺序。

具备本地化条件是什么意思?

意思是把文案交给译者或翻译工具,对方无需猜测就能产出忠实的译文。 这需要满足三个条件:每条字符串都只存在于一个公认的位置,每条字符串只表达一件清晰的事,译者能看出它用在哪里、怎么用。

这三点事后补救的难度并不相同。措辞可以逐条改进,上下文可以用备注补充,但“只存在于一个公认的位置”属于结构问题。缺了这一点,另外两点就没有稳定的依托:同一条字符串在另一个文件里还有一份副本,你就没法改进它;一条消息没有唯一的地址,你就没法为它加注释。

为什么源文本决定了翻译质量的上限?

因为翻译是衍生作品,而衍生作品会继承源头的所有缺陷。 译文会把源文本的歧义带进每种目标语言,不一致同样如此。如果源文本在一个界面写 “Sign in”,在另一个界面写 “Log in”,第三个界面又写 “Login”,那么每种语言里就有了三个术语,各自独立翻译,谁才是想要的那个,无从判断。

这也是常见的补救办法(打磨译文)抓错了环节的原因。每多一种语言,没修好的源文本带来的成本就多一倍。把源文本修好一次,所有语言同步受益,包括你尚未添加的语言。

这种底层问题有个名字。文案漂移(copy drift)是指用户可见的文本在不同界面、不同时间点偏离其认可的源文本,没有单一事实来源。什么是文案漂移介绍了成因。到了本地化阶段,它的代价才真正变高,因为漂移会被复制进每一种语言。

为什么散落的文案无法具备本地化条件?

因为没有东西可以交付。 组件里的字面量并不是翻译环节能够直接取用的单元。它和标记、逻辑混在一起,可能由多个片段拼接而成,同一句话还可能出现在多个文件中,带着没人有意为之的细微差异。

就地重写这些字面量并不能改变这一点。你可以让每条都更清晰,但依然没有目录,没有一份公认的“产品到底说了什么”的清单,也无从确认是否已经找全。结果只是同样散落的位置上,文本更整洁了而已。

所以第一步不是编辑,而是收集:把所有用户可见的字符串收进同一个目录,使用同一种源语言,放在仓库里,由组件通过键来引用。收集时不改动措辞。这一轮的目的,是摸清产品目前到底说了什么,包括那些相互矛盾的部分。

如何收集字符串?

先移入目录,再做优化。 这样排序有两个原因。边移动边改写的混合操作,会让评审者和你自己都看不清到底改了什么。而一旦所有内容都在同一个文件里,重复项和近似重复项就不再隐形:它们彼此相邻,清理工作只需要读一个文件。

具体做法:

  • 每种源语言在仓库里选定一个目录。 作为文案的权威版本,人和工具都能读取。目录如何布局、键如何命名,见如何在代码库中保持 UI 文案一致;那是同一个目录,所以布局以那一页为准,本文不再重复。
  • 用键引用替换字面量。 覆盖用户能读到的每一条字符串,包括按钮标签、错误消息、空状态、工具提示和无障碍文本,这些通常最容易被漏掉。
  • 保持句子完整。 如果一条消息是拼接片段得来的,就改成带变量的单个条目,让译者看到的单元就是用户读到的单元。不同语言的语序不同,在代码里拼出来的句子无法适配。
  • 先别改措辞。 忍住。你会发现一些别扭的写法,记下来,继续往前走。

如果这份清单读起来像是在大型代码库里要耗上一个月的细致工作,那正是这一步的真实成本,也是大多数团队卡住的地方。

字符串都进了同一个目录之后做什么?

现在,那些耳熟能详的建议终于有了落脚点。 有了统一的目录,下面每一项都只需一轮处理,不必四处搜寻:

  1. 清除重复项和近似重复项。 为每条消息选定认可的措辞,让所有用到的地方都指向它。
  2. 固定绝不能变的术语。 功能名称、核心操作的动词、你决定不用的词。统一写下来一次。这就是你的术语表,而且很短。
  3. 用平实的语言撰写。 主动语态,不用习语,不用依赖某一种语言文字游戏的玩笑,可能被误读的缩写要写全。每条字符串只说一件事。
  4. 给译者提供上下文。 注明字符串出现在哪里、变量代表什么。像 “Post” 或 “Order” 这样的短字符串是典型陷阱:名词还是动词?目标语言可能两种词性要用不同的词。
  5. 为长度留出余量。 译文往往比源文本长,所以设计布局时要保证标签变长也不会破版。把它当作设计约束,而不是一个用来估算的数字。

每一步都很快,因为目录就是这些操作发生的唯一位置。没有目录,同样的五步就成了在代码库里的五次寻宝,你永远不知道什么时候才算做完。

选择翻译供应商或工具之前,应该先确定什么?

源文本和审核流程。 供应商或工具翻译的是你交给它的内容。给它一份干净的目录和一张简短的术语表,它就能做出好结果;给它散落的字面量,你就得先花钱翻译这些不一致,再花钱在每种语言里逐个修正。

先定三件事:哪个文件是唯一事实来源;谁来批准措辞改动;变更或新增的字符串如何进入翻译环节,是手动、脚本,还是随译文一起到来的 PR。最后一种最能避免译文落后于源文本,这个问题在翻译文件为什么会不同步里有详细说明。

文案已经在仓库里时,会有什么变化?

本地化不再是一个独立的项目。 文案目录放在仓库里,新增或变更的字符串就是 diff 里的一行,它的译文可以和代码走同一套 PR 流程来生成和审核,没人需要再导出电子表格,然后祈祷它能原样回来。

这就是为什么在代码库里,保持文案一致和让文案随时可本地化其实是同一件事。两者都依赖同一个公认的源文本,做一次就能两头兼顾。使用 AI 编码工具的团队会更早感受到这一点,因为除非有目录和 lint 规则拦着,Agent 会悄悄改写文案,或者重新引入字面量;如何阻止 AI 编码 Agent 改写你的 UI 文案讲的就是这种情况。

globalize.now 的定位

globalize.now 是内置本地化能力的代码原生文案管理系统,上文提到的统一来源这一步,就由它替你完成。 你在应用中连接 GitHub 或 GitLab 仓库,扫描会识别现有内容。如果字符串是组件里的字面量,一次性转换会把它们改为通过键引用并移入目录,没有 i18n 配置的话还会补上;如果你已经在用 next-intl、react-i18next、i18next 或 Lingui 之类的库,它会沿用你现有的方案。结果会作为 PR 提交在独立分支上,所以第一份目录同样会经过上文所说的审核。此后,你新增的源字符串由推送任务翻译,并通过 PR 提交结果。仓库始终是唯一的事实来源,已有 i18n 的接入指南介绍了在已有配置时,扫描会发现什么。

我们的目标是让营销网站、落地页和产品从同一个来源出发,遵循同样的规范。这是我们的方向,而不是现在就能购买的功能。定价见定价页面。

顺序速览

  1. 把所有用户可见的字符串收进仓库中的同一个目录,不改措辞。
  2. 保持句子完整,每条字符串都通过键引用。
  3. 清除重复项,一次性选定认可的措辞。
  4. 编写一份简短的术语表,收录绝不能变动的术语。
  5. 按平实语言润色,并为译者补充上下文备注。
  6. 确定由谁批准措辞,以及变更的字符串如何进入翻译环节。
  7. 做完这些,再选择或更换翻译供应商或工具。

如果第一步看起来像是要花一个月,不妨连接仓库,看看它给出的方案,再审核它提交的 PR。

globalize.now 把硬编码的应用文案转换为可直接翻译的语言文件,并在你持续发布时保持同步更新。

免费试用 globalize.now