CSV 转 JSON 与 API Fixture

样例数据常常以 CSV 形式到达，而开发者往往需要 JSON。

用于 API mock、测试和文档时，表头行通常适合映射为 JSON 对象 key：

id,name,active
1,Ada,true

[
  {
    "id": 1,
    "name": "Ada",
    "active": true
  }
]

类型推断是一种选择

把 "1" 转为 1、把 "true" 转为 true 对 fixture 很有用。但在这些场景中可能危险：

• 有前导零的账户 ID
• 邮编或区域编码
• 很大的数字标识符
• 看起来像数字但本质是字符串的编码

精确文本很重要时，应关闭类型推断。

API fixture 检查清单

• 使用和 API 契约一致的稳定表头名。
• 单元测试中的样例行数保持小而清晰。
• ID 或编码需要精确保留时，不要自动转数字。
• 重要载荷生成后，用 JSON 格式化或 Schema 再检查一次。

关键结论

CSV → JSON 不只是格式变化，也是结构决策：key、类型、null 和数组都要符合目标 API。

可以在 CSV 转换工具 中分别开启和关闭类型推断，对比 fixture 输出。