結論先說
- 軟件本地化翻譯和普通散文翻譯是兩碼事,第一鐵律是「死保結構與插值變量一字不動」:必須在提示詞裏明確列出當前框架用的佔位符格式(如
{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 條評論
還沒有評論,來搶沙發~