2026-05-31 · 约 1 分钟阅读
从 CSV 到 JSON：表头与类型陷阱
表头会成为键名；大规模转换前先规范化列名。
CSVJSON数据
要点
- 先确认分隔符与首行是否为表头。
- CSV 无强类型，数字在 JSON 中可能仍是字符串。
表头与空值
不同导出方式会影响分隔符与首行；Excel 导出也因区域设置而异。
空单元常被解析为 null 或空字符串，要在业务侧统一约定。
生成 JSON 之后
可用 JSON Formatter 便于审阅，再进入生产前用 JSON Validator 做语法检查。
中文字段与表头映射清单
导入前先把 CSV 表头与目标 JSON 字段一一对应：业务主键、展示名、时间列应分开命名，避免把「创建时间」和「更新时间」映射到同一键。
若表头含 BOM 或全角逗号，先在表格工具里另存为 UTF-8 CSV，再进入 JSON 转换，可减少列错位。
批量接口通常要求数组元素结构一致；映射完成后用 JSON Validator 抽一条样本校验类型（字符串、数字、布尔）是否符合后端约定。
常见问题
为何数字变成字符串？
CSV 本质是文本；除非在下游显式转换，否则常按字符串保留。
CSV 转换是否上传服务器？
会，文件类工具由服务端处理。
中文表头需要转成英文键名吗？
取决于 API 契约。若后端接受中文键可保留；若 OpenAPI 定义为英文字段，应在映射阶段统一，避免运行时再做隐式重命名。