JSON 转 CSV

JSON 是一棵树，CSV 是一张网格，所以两者之间的每一次转换都是关于「如何压平这棵树」的决定。几乎所有意外都来自这里，而不是来自某个具体工具；知道做了哪一种决定，才是能信任结果的前提。

干净的情形是一个由扁平对象组成的数组：每个对象成为一行，每个键成为一列，什么也不会丢。麻烦始于某个值本身是对象、不同记录带着不同的键，或者记录里出现了数组。嵌套对象会被压平成带点号的列名，于是一个包含城市的地址对象变成 address.city 这一列。键不同的记录会产生所有列的并集，记录中没有的地方留空。这通常正是电子表格想要的，但值得确认而非假设。

类型无法穿越这道边界。CSV 没有数字、布尔或 null 的概念；每个单元格都是文本，而随后打开这个文件的程序会套用它自己的猜测。正是在这里，带前导零的标识被悄悄改成整数，很长的数字 ID 变成科学计数法，一种格式的日期在另一种区域设置下变成另一个日期。如果数据要进电子表格，那么该表格的导入设置和这次转换同等重要。

记录内部的数组是没有好答案的情形。网格无法在不选定某种约定的前提下表示单元格里的列表，而每一种约定都会在某个方向上有损：用分隔符连接，则任何含有该分隔符的值都会出错；展开成编号列，则形状会随最长的那条记录而变。这是该亲手检查而非信任的情形。

实用的检查只需十五秒，并且能抓住上述全部问题：打开结果，找一行您已经知道正确值的记录。如果标识仍带着前导零、日期仍是您预期的那一天，这次转换就做了您想要的事。如果不是，您现在就知道了，而不是在转交之后。

转换在您的浏览器中运行。这一点要紧，因为被转成 CSV 的 JSON 几乎总是发往电子表格的导出，也就是说通常是关于真实的人的真实记录，而那正是不该上传到某个服务去重新整形的文件。