用 Claude 翻译软件多语言国际化(i18n JSON)与技术文档:锁定术语表与占位符防改坏指南

把前端 zh.json 语言包或 Markdown 技术手册直接扔给翻译工具,经常把 {{userName}} 变量翻成中文导致页面白屏?本文详解用 Claude 锁定双语术语表、保护 ICU 复数语法的三套提示词与自动验键脚本。

NNathaniel bigo··原创首发·AI 辅助撰写
8 分钟读完
资料核对于 2026-11-19 · 依据官方文档与公开资料整理 Pro 账号

结论先说

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

安全翻译软件 i18n 语言包四步流程

图:本站结合 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 充值页 获取自助卡密兑换,支持开具增值税发票,实时价格与售后边界(封号不在质保范围)见各商品页。

相关教程

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同模型

  1. 01

    Anthropic Contextual Retrieval(上下文增强检索)是什么、怎么实现:给文档块自动补背景摘要结合缓存降失误率

    长文档切成小块后丢了公司名、年份和主语指代导致 RAG 频频搜错?本文按 Anthropic 官方技术文章详解 Contextual Retrieval 原理、官方公开评测失误率下降 49% 至 67% 的组合架构,以及用 Claude 提示词缓存低成本批量生成切片背景的完整 Python 代码。

    Claude其他 AI 工具0
  2. 02

    写代码兼顾办公,同时订「ChatGPT Plus + Claude Pro 双会员」还是单上「Max / Pro 高阶档」怎么算账

    每月花 $40 同时订 ChatGPT Plus + Claude Pro 双会员,还是花 $100 单上 Claude Max 或 ChatGPT Pro 100?本文按两家官方定价页拆解编程智能体、多模态办公、限额容灾与独占功能账本,给出清晰选型公式。

    ChatGPTClaude0
  3. 03

    Notion AI 怎么收费、包含在套餐里还是单独买:工作区知识问答、数据库自动填表与对比 Claude / ChatGPT 选型

    Notion AI 现在还能单独加购吗?按 Notion 官方现行定价页,完整 Notion AI 已直接打包进 Business(年付 $20/成员/月,月付 $24)与 Enterprise 套餐,Free 和 Plus 仅含少量试用。本文讲清计费变化、三大核心功能及与独立会员的取舍。

    其他 AI 工具0
  4. 04

    Raycast AI(Pro / Pro+ / Max)是什么、怎么配 BYOK 自带密钥:快捷呼出 Claude 与 GPT 桌面工作流

    Raycast AI 支持在桌面端全局快捷键呼出 Claude、GPT 与 Gemini。本文按官方手册说明 Raycast Pro、Pro+、Max 积分档位差别,以及配置 BYOK(自带 API 密钥)的前置条件、设置步骤与快捷指令工作流。

    其他 AI 工具0
  5. 05

    Perplexity Pro 值得买吗:每月 $20 比免费版多什么、可选哪些 Claude / GPT 模型与深度检索用法

    Perplexity Pro 月付 $20(年付约 $17/月),比免费版多出高配额 Pro 搜索、切换 Claude 与 GPT 模型及更高频的 Deep Research 深度检索。本文对比各档权益,帮你判断订它还是独立对话会员。

    其他 AI 工具0
  6. 06

    Claude API Citations 原文引用结合 Files API 搭建可溯源企业制度问答指南

    搭公司内部报销、法务或操作规程问答机器人,不想折腾复杂的切片向量数据库又怕大模型胡编页码?本文按 Anthropic 官方文档详解用 Files API 传一次 PDF 拿 file_id,结合 Citations 原生返回精确页码与原文摘录的完整架构。

    Claude0

同产品的其他教程

  1. 01

    RAG 知识库回答不准怎么调优:切片大小(Chunking)、BM25 + 向量混合检索与 Rerank 重排序三步排查法

    搭好的 RAG 企业知识库一问具体型号、报错码或跨行表格就答非所问?本文按 OpenAI 与 Anthropic 官方检索文档,给出先隔离检索与生成故障、再按结构化切片(Chunking)、BM25 加向量混合召回(RRF)与 Rerank 重排序逐层调优的三步法。

    Claude其他 AI 工具0
  2. 02

    Langfuse 开源本地部署(Docker Compose)与提示词版本管理(Prompt Management)从零上手教程

    企业内网严禁业务日志出境,又想免费拥有大模型调用链追踪与不发版热更新提示词的能力?本文按 Langfuse 官方文档整理 Docker Compose 本地一键启动(含 ClickHouse 架构注意事项)、密钥配置与 Prompt Management 标签化版本管理全流程。

    Claude其他 AI 工具0
  3. 03

    LangSmith 入门教程:给 LangGraph 与原生 OpenAI / Claude 接口加调用链追踪、Token 成本统计与免费层限额

    智能体多步调用总是找不到哪一轮提示词跑偏、单次请求到底烧了多少 Token?本文按 LangSmith 官方文档讲清环境变量零侵入接入 LangGraph、用 wrap_openai / wrap_anthropic 与 @traceable 追踪原生接口,以及 Developer 免费层额度与留存规则。

    Claude其他 AI 工具0
  4. 04

    Zotero 搭配 Claude / ChatGPT 高效读英文文献:PDF 翻译插件、批注导出精读与防捏造参考文献流程

    在 Zotero 里读英文顶会论文怎么无缝联动 Claude 与 ChatGPT?本文整理 Translate for Zotero 划词翻译配置、高亮批注导出精读提示词,以及杜绝 AI 捏造假 DOI 参考文献的核验闭环。

    Claude其他 AI 工具0
  5. 05

    Obsidian 接入 Claude、ChatGPT 与本地 Ollama 做个人双链笔记问答:主流插件配置与隐私脱敏边界

    想在 Obsidian 里基于自己的双链笔记库做 AI 问答又担心隐私外泄?本文对比 Copilot 与 Smart Connections 插件,整理接入 Claude、OpenAI 官方 API 与本地 Ollama 的步骤及敏感目录隔离规则。

    Claude其他 AI 工具0
  6. 06

    Excalidraw 结合 AI 怎么画架构图:Mermaid 代码一键转手绘风图表与 Excalidraw MCP 自动生图做法

    想用 AI 快速画出可自由拖拽修改的手绘风系统架构图?本文整理 Excalidraw 内置 Mermaid 转图表、Text to Diagram 与挂载 Excalidraw MCP 自动读取代码生成架构图的三套完整流程。

    Claude其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~