JSON/YAML/CSV 数据互转指南
目标：减少“转出来能打开但数据不对”的情况，让接口数据、配置文件和表格数据在转换前后都能核对。最近更新：2026-05-01
开发/数据格式转换校验清单
一、三种格式适合的场景
- JSON：适合接口返回、前端状态、嵌套结构。
- YAML：适合配置文件，可读性好，但缩进敏感。
- CSV：适合表格和批量导入导出，但不擅长表达嵌套对象。
二、互转前先看结构
最适合转 CSV 的 JSON 通常是“对象数组”：[{"name":"A","age":18}]。如果 JSON 是多层嵌套，转成 CSV 时要决定字段如何展开，例如 user.name、user.age。
转换前检查：是否每行字段一致、是否有数组嵌套、数字和字符串是否需要保留原样、中文编码是否正常。
三、可复现流程：接口 JSON 转成表格
- 先用 JSON 格式化 校验语法。
- 用 JSONPath 提取 取出真正需要的数组。
- 再用 JSON/YAML/CSV 互转 输出 CSV。
- 如果要给开发使用，可用 JSON 转 TS 接口 或 JSON 转 Schema 固化结构。
四、转换后怎么验收
- 行数是否等于原数组长度。
- 关键字段是否为空、错列或被截断。
- 手机号、身份证号、订单号等长数字是否被表格软件改成科学计数法。
- 日期字段是否被自动转成本地时区或不同格式。
- 导入系统前，先用 3-5 行样例跑一次。
数据转换工具不理解你的业务含义；它能处理格式，但最终仍需要你核对字段口径。