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 的香港用词只换少数词,例如「鼠标」转成「滑鼠」,「软件」则保持香港常用的「軟件」。