结论先说
- 软件本地化翻译和普通散文翻译是两码事,第一铁律是「死保结构与插值变量一字不动」:必须在提示词里明确列出当前框架用的占位符格式(如
{name}、{{total}}、%d、<0>链接</0>)严禁改动。 - 开翻之前先喂一张不超过 50 词的「核心双语术语表(Glossary)」:建议建一个专属 Claude Project 把产品专有名词表挂进去,哪怕分十次翻十个子模块,全站用词也能严丝合缝。
- 按钮文案必须交代 UI 容器位置,防止长语种撑爆排版:英文
Save只有 4 个字母,翻成德语或俄语可能长出三倍,不提前限制字符宽度会把移动端顶部栏挤折行。 - 批量翻译十几个语种语言包与长篇开发文档较耗上下文额度:需要稳定大窗口吞吐时,可查看本站 Claude Pro 充值说明 或自动发卡的 Claude Pro iOS 自助充值商品页。

图:本站结合 Claude 官方提示词规范 整理的四步软件国际化工作流示意图
本文根据 Anthropic 官方提示词工程与 Projects 功能说明(support.claude.com)整理,资料核对于 2026-11-19。配图为本站整理的示意图,不是软件截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 做软件出海(SaaS、App、浏览器插件),要把几百个键值的
zh-CN.json一次性翻译成英文、日文、德文或西语的前端与独立开发者; - 被传统机器翻译坑过——比如把插值占位符
{{count}}翻成了{{数量}}、把 Markdown 锚点链接改断、或者同一个Workspace在前半篇叫「工作区」后半篇叫「工作空间」的团队; - 想搭一套「AI 批量初译 + 本地脚本百分百防漏键验伤」标准流程的工程师。
一、裸翻必踩的三个工程大坑与三套防改坏提示词

图:本站整理的前端语言包裸翻常见事故与工程护栏效果对比表
把下面三套提示词放进你的本地化 Project(工作台搭法见 用 Claude Projects + Styles 搭团队工作台),用 XML 标签 <glossary> 和 <source> 把规则与待译内容隔干净:
1. 前端 i18n JSON 语言包零破损翻译(含 ICU 单复数保护)
text
你是资深软件本地化(L10n)工程师。请将 <source_json> 中的简体中文界面文案翻译为地道、简洁的美式英语(en-US),严格遵守以下工程硬约束:
1. JSON 键名(Keys)与嵌套层级必须与原文件百分之百一致,严禁增删、重排或翻译任何键名;
2. 严禁修改或翻译任何插值占位符与富文本标签,包括但不限于 {{variable}}、{count}、%s、%d、<1>...</1> 以及换行符 \n;
3. 遇到 ICU MessageFormat 语法(如 {count, plural, one {...} other {...}}),保留语法关键字(plural/select/one/other),在目标语种下正确补齐单复数分支文案;
4. 严格遵循 <glossary> 术语表:例如「工作区」固定译为 Workspace,「额度」固定译为 Quota;按钮类短键值优先使用精炼祈使动词(如 Save、Cancel、Retry),去除中式冗余宾语。
仅输出合法的单块 JSON 代码,不要附加前后解释文字。
2. MDX / Markdown 开发者技术文档翻译(保护代码块与锚点)
text
请将下方的中文开发者文档(MDX 格式)翻译为自然流畅的英文技术文档,严格保留工程结构:
1. 原样保留顶部 YAML frontmatter 中的 slug、id、icon 等路由配置字段,仅翻译 title 与 description 的字符串值;
2. 三重反引号代码块内的代码标识符、命令行参数与终端报错原文一律保持原样,仅翻译代码行内的中文解释注释;
3. 原样保留所有自定义组件标签(如 <Callout type="warning">)的属性名与内部相对路径链接,切勿翻译 URL 路径。
3. 德语 / 西语 / 法语等长词语种的移动端窄屏防溢出重审
text
请检查这份刚译好的德语(de-DE)移动端界面语言包,挑出所有键名以 btn_、tab_、badge_ 开头且译文字符长度超过英文原版 1.5 倍的条目,按「键名 / 当前过长译文 / 不损原意的地道缩略替代表述」三列输出优化建议,防止撑破手机底部导航栏与胶囊按钮。
长文档精读与高频生产力订阅入口:无论是往 Projects 挂载几十份背景资料、审阅几十页英文商业合同,还是连续绘制复杂架构图,免费版短窗口配额极易受限。国内用户可通过本站支付宝、微信支付或 AlipayHK 免上号自助开通 Claude Pro 会员(直达单品 Pro iOS 自助充值)或大额度 Claude Max 充值。
二、合入代码库前必跑:15 行 Python 自动验键与占位符脚本
永远不要只凭肉眼扫一眼就合入几百行 JSON 语言包。把下面这段零依赖校验脚本存为 check_i18n.py,十毫秒就能抓出漏键或被改坏的 {变量}(如果在本地仓库直接让终端智能体批量跑十个语种,也可配合 Claude Code Python 自动化脚本入门):
python
import json, re
PLACEHOLDER_RE = re.compile(r"\{\{[^}]+\}\}|\{[a-zA-Z0-9_]+\}|%[sd]")
def flatten(obj, prefix=""):
out = {}
for k, v in obj.items():
nk = f"{prefix}.{k}" if prefix else k
if isinstance(v, dict): out.update(flatten(v, nk))
else: out[nk] = str(v)
return out
src = flatten(json.load(open("locales/zh-CN.json", encoding="utf-8")))
tgt = flatten(json.load(open("locales/en-US.json", encoding="utf-8")))
assert set(src.keys()) == set(tgt.keys()), f"键名不一致: 缺失 {set(src)-set(tgt)}"
for k in src:
assert set(PLACEHOLDER_RE.findall(src[k])) == set(PLACEHOLDER_RE.findall(tgt[k])), f"占位符被破坏: {k}"
print("i18n 键树与插值变量核验全部通过")
常见问题
问:一份 zh-CN.json 有三千行,一次性贴给 Claude 会不会在输出到第两千行时断掉?
答:单次输出 Token 上限(Max output tokens)远小于输入窗口上限。三千行的 JSON 不要一口气让它全吐出来——按顶层业务模块(如 auth、billing、dashboard)拆成每次 200 到 300 行的块分批翻译,既不会触发输出截断,准确率也最高(超长会话限额说明见 Claude 上下文太长限制处理)。
问:日文和韩文翻译要注意什么额外细节?
答:日韩界面最怕敬语层级前后打架(一会用礼貌体 です/ます,一会变简体普通形)。在提示词里加一句「全站统一采用现代 SaaS 标准礼貌体(丁寧語),外来语技术词汇按日本开发者社区惯用片假名书写」即可稳住调性。
问:几十个仓库每次发版都要增量翻译新增的十几个 Key,怎么自动化?
答:用 git diff 抽出本次只在 zh-CN.json 新增的那十几个键值,调用结构化 JSON 接口(见 Claude API 结构化输出指南)只翻增量再合并回各语种文件,每次发版几美分就能跑完,完全不用全量重翻整包(英文文档润色对照另见 Claude 润色改写指南)。
问:阿拉伯语或希伯来语这种从右往左(RTL)书写的语言包有什么特别坑?
答:除了照常保护 {变量} 原样不动之外,RTL 语言里如果夹杂英文品牌名、数字或斜杠路径,容易出现双向文本(BiDi)显示顺序颠倒。建议在提示词里提醒模型不要手动往 JSON 字符串里塞不可见的 Unicode 方向控制符,而是交给前端 CSS 的 dir="rtl" 与逻辑属性(如 margin-inline-start)统一接管布局翻转。
问:新注册 Claude 收不到手机验证码,或者没有外币卡怎么开通 Pro / Max 会员?
答:注册受阻可先看本站 Claude 注册与普号说明页;已有账号升级会员可直接前往 Claude Pro 充值页 或 Claude Max 充值页 获取自助卡密兑换,支持开具增值税发票,实时价格与售后边界(封号不在质保范围)见各商品页。
0 条评论
还没有评论,来抢沙发~