JSON 是網站和應用程式存放資料、設定和多語言文案(i18n 語言包)最常用的格式。語言包通常是"键名": "文案"的對應,程式靠鍵名找到文案,所以轉換時鍵名不能動,結構和格式也最好原樣保留,方便和原檔案對照。
會轉換的內容
- 字串值,包括陣列和巢狀物件裡的字串。
- 用
\u跳脫寫的中文,例如\u5934\u53d1。 - 鍵名(可選,預設關)。
保持不變的內容
- 鍵名、數字、
true、false、null和物件、陣列的結構。 - 縮排和格式。有變化的字串重新編碼,其餘位元組原樣保留。
編碼與相容
JSON 標準要求在系統之間交換時使用 UTF-8,很多程式也預設按 UTF-8 讀取。原檔案是 GBK 或 Big5 時會被自動識別,輸出一律是 UTF-8;BOM 預設跟隨原檔案,原來沒有 BOM 的檔案不會被加上。
轉換範例
| 原文 | 結果 |
|---|---|
| {"title": "软件设置"} | {"title": "軟體設定"} |
| {"menu.file": "文件", "menu.help": "帮助"} | {"menu.file": "檔案", "menu.help": "幫助"} |
| {"msg": "内存不足,请关闭后台程序"} | {"msg": "記憶體不足,請關閉後臺程式"} |
| {"count": 3, "enabled": true, "label": "打印机"} | {"count": 3, "enabled": true, "label": "印表機"} |
| {"tip": "\u70b9\u51fb\u4fdd\u5b58"} | {"tip": "點選儲存"} |
由 OpenCC(s2twp)實際轉換生成。
怎麼用
- 把 zh-CN.json 這類語言包拖到頁面上,或點「選擇檔案」,多個語言包可以一次選上。
- 方向選「簡→繁」,標準選「臺灣」或「香港」;「轉換地區用詞」預設開啟,介面用語會換成當地說法。
- 看卡片上的「轉換 N 處」和預覽;不合法的 JSON 會單獨提示。
- 下載檔案。預設加語言字尾,例如 messages.zh-CN.json 會變成 messages.zh-Hant-TW.json。
注意事項
- 地區用詞按詞典替換,不理解語義。例如「文件」一律轉成「檔案」,指公文時也一樣;「点击保存」會變成「點選儲存」。介面文案上線前,最好請熟悉當地用語的人過一遍。
- 字串值整段轉換。如果值裡有中文路徑或網址,例如 /分类/软件,也會被一起轉換,請留意這類欄位。
- 像 {name}、%s 這樣的 ASCII 佔位符不會被改動;用中文寫的佔位符會被轉換。
常見問題
鍵名會被轉換嗎?
預設不會,程式靠鍵名查詢文案,改了就找不到。中文鍵名也需要轉換時,在進階選項裡開啟「JSON:鍵名也轉換」。
用 \u 跳脫寫的中文能轉換嗎?
能。跳脫序列會先解碼再轉換;有變化的字串用 UTF-8 字元直接寫回,沒有變化的保留原來的寫法。
檔案會被重新排版嗎?
不會。縮排、空格、換行和鍵的順序都不變,沒有變化的部分逐位元組保留,用 Git 比較時只會看到改動的文案。
帶註解的 JSON 怎麼辦?
帶註解或末尾多逗號的檔案不是合法 JSON,卡片會提示「不是合法的 JSON,沒有轉換」。這時可以點「按純文字轉換」,但鍵名裡的中文也會一起轉換。
簡體語言包轉香港版該怎麼選?
方向選「簡→繁」,標準選「香港」,保持「轉換地區用詞」開啟。OpenCC 的香港用詞只換少數詞,例如「鼠标」轉成「滑鼠」,「软件」則保持香港常用的「軟件」。