用 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 條評論

登入 後參與評論

還沒有評論,來搶沙發~