把 i18n 语言文件摊成译者能改的 Excel,改完再原样收回 JSON——嵌套键路径、占位符、转义、键顺序全保真,回填不串行、层级不塌。不是泛 JSON 转表格,是给本地化工作流的那一道工序。
这一转换存在的理由,是让工程和译者各用自己顺手的工具,中间不丢东西。
前端 / 客户端最常用的语言文件:键值对,常带嵌套(menu.start.label)、数组与复数分支(items[0]、ICU plural),值里夹着占位符({name}、%s)和转义(\n、\uXXXX)。工程顺手,但不是给人在里头逐条改的。
译者、审校、外包最顺手的界面。一行一条,key 与译文并排,筛选、批量改、加批注都自然。代价是:裸 Excel 会把嵌套层级拍平、把 {name} 当普通文字、把 \n 自动更正——回工程那头就装不回去了。
本工具守住的就是那点「装不回去」:导出时把嵌套键路径、数组 / 复数索引、占位符、转义全部如实带进表格;改完导回时按 key 精确回填、还原层级,行顺序乱了也不串。这是「懂行的人才会查」的保真细节,通用 JSON 转 Excel 工具多半不管。