首页/AI/提示词工程速查/保留标记与格式的翻译
任务型写法50 条

保留标记与格式的翻译

翻译带占位符、标签或代码的文本:占位符与标记原样保留、位置可调、内容不译;只翻自然语言部分。

提示词工程速查AI更新于 2026-10-13

保留标记与格式的翻译

翻译带占位符、标签或代码片段的文本时,规则是:占位符与标记原样保留、位置可以按目标语序调整、其内容不翻译;只翻自然语言部分。交付前用程序做一次占位符数量与集合比对、标签配对检查——这是成本极低但能拦住大部分线上事故的自动检查。

基本信息

占位符原样保留、允许移位;翻译后核对数量与集合
标签结构不动,只译标签之间的文本节点
代码代码块内容不翻译
核对程序比对占位符集合与标签配对,低成本自动检查

典型使用场景

  • 通知模板本地化:模板变量在翻译中不能被改掉
  • 界面文案:HTML 标签结构必须保持,只译文本节点
  • 邮件模板:变量与格式标记混排,需要逐项核对
  • 文档站点:代码示例保留原文,说明文字翻译
  • 多语言消息:ICU 复数形式的各分支都要覆盖

保留标记模板

保留标记模板
翻译下面的文本:

- 保留所有花括号占位符(如 {name}、{count})原样不动
- 占位符可在句中移动位置以符合目标语语序
- 保留 HTML 标签结构与全部属性,只翻译标签之间的文本
- 代码片段(<code> 内)不翻译
- 数字、日期格式保持原文,不做本地化换算

输出:只输出译文,不要添加说明。
文本:<text>……</text>

# 交付前自动核对
# 1) 占位符集合与数量逐项比对
# 2) HTML 标签配对与顺序一致性检查

元素处理对照

元素处理方式核对方式
花括号占位符原样保留,可移位集合比对 + 数量核对
HTML 标签结构不动,只译文本节点标签名与顺序配对检查
标签属性全部保留不改属性名与值逐项比对
代码片段不翻译代码块内容哈希比对
ICU 复数分支每个分支都翻译分支数量与关键字检查
模型偶发会把 {name} 这类占位符翻译成中文(例如译成「名字」)。这类错误在界面上表现为变量原样显示,交付前必须做占位符校验,不能只看译文顺不顺。
ICU 复数形式(plural)的语言分支较多,漏翻某一个分支只有在运行时遇到该数量时才暴露,属于典型的后置故障。核对时按分支逐一确认。

易错点

  • 占位符被翻译成目标语言,运行时界面上直接显示变量名或缺失值
  • ICU 复数形式只译了主分支,其他数量分支未覆盖,运行时才暴露错误
  • HTML 标签属性被顺手翻译,导致链接或样式失效
  • 不做自动核对,靠人工通读译文,占位符错误在长文本里很难被发现

数据来源与参考

  • 软件本地化文件格式规范(gettext PO 与 ICU MessageFormat 占位符约定)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌