先写清楚接口需要哪些字段和类型
CSV 转 JSON 前，先拿接口示例或字段说明核对键名、必填项与类型。转换器可以把行列整理成 JSON 数组，却不知道 order_id 应是字符串、amount 应是数字，还是空白字段应改成 null；这些规则必须由使用数据的人决定。
例如订单文件包含 order_id,amount,paid,note 四列，其中订单号是 000381，金额是 125.50，付款状态是 false，备注为空。订单号前导零必须保留，金额可能要传数字，false 也不能被当成普通文字。先在一小份不含真实客户信息的样本上写出预期 JSON，再开始整批转换，能更快发现类型与命名不一致。
标题行也要逐个检查。键名应唯一、没有前后空格，并与接口大小写完全一致。order_id 和 orderId 对程序来说通常是两个不同字段；两个都叫 price 的重复标题更危险，因为转换后的对象无法可靠保留同一层级里的两个同名键。
用 CSV JSON 互转工具生成第一版结构
打开CSV JSON 互转工具（csv-json），把样本 CSV 粘贴到 CSV 输入框，确认分隔符，并保留“第一行是表头”选项，再执行 CSV → JSON。工具会用第一行作为对象键，把后续每一行变成数组中的一个对象。
这个页面处理的是粘贴进去的文本，不会读取或编辑电脑里的 Excel 工作簿。若手上是 CSV、TSV、XLSX 或 XLS 文件，可以先用CSV / Excel 在线预览工具查看工作表与明显的列错位，再复制经过授权的非敏感样本；两个工具之间不会自动传送文件内容。
转换器支持单个自定义分隔符，也能识别双引号包住的逗号、换行和成对双引号。格式错误的引号会触发错误，而不是由工具猜测应该在哪里结束字段。先处理五到十行有代表性的样本，包括空字段、含逗号备注和末尾缺值的记录，再扩大范围。
空字符串、null 和缺少字段不能混为一谈
当前转换结果会把 CSV 单元格内容保留为字符串，空字段会得到空字符串 ""。它不会自动把 125.50 改成数字，也不会把 false 改成布尔值，更不会自行决定空白应变成 null 或删除该键。
这三个状态在接口里可能有不同含义：
- 空字符串可能表示用户明确提交了一个空文本值。
null可能表示字段存在，但目前没有值。- 缺少字段可能表示没有提交、使用默认值，或请求不允许更新该字段。
因此不要在不清楚接口规则时进行全局替换。先用接口文档列出需要转换的字段，只对金额、数量、真假值等明确字段做类型处理；邮编、员工号、订单号和带前导零的编号通常应继续保留为字符串。正式发送前还要通过应用代码或接口验证器检查数据，不能把浏览器里的文本转换结果当成接口已经接受。
特别检查重复标题、缺列和多余列
标题与数据行宽度不一致时，生成的 JSON 仍可能看起来整齐，所以要主动找边界情况。当前工具遇到某行少于标题数量时，会为缺少的位置填入空字符串；某行多出标题以外的值时，多出的值不会成为新键。
重复标题也要在转换前修正。对象不能同时可靠表达两个同名键，后出现的同名字段可能覆盖先出现的值。空白标题则会产生难以使用的空键。转换前先把标题改成明确且唯一的名称，例如把两个 price 分为 unit_price 与 shipping_price，并记录这种改名如何映射到接口字段。
转换完成后，可把结果粘贴到JSON 格式化与验证工具检查 JSON 语法和层级。它能确认文本可被 JSON 解析，但不能验证接口架构、业务必填项、货币精度或订单是否真实存在。
用已知订单做提交前核对
提交前选一条容易辨认的测试订单，从原始 CSV 一直对照到 JSON。检查键名、字段数量、前导零、中文与引号内容，并确认空值采用了接口要求的表示方式。然后在测试环境或接口提供的校验端点只发送少量数据，查看实际错误响应。
若接口报错，不要马上重转全部文件。先判断是 JSON 语法、字段类型、必填项、鉴权，还是业务规则问题。保存未经修改的 CSV 副本、字段映射说明和一小份测试结果，修正后再从同一来源重做，避免在多个临时版本之间猜测哪份才正确。
常见问题
为什么 CSV 里的 00123 转成 JSON 后仍是字符串？
当前工具保留 CSV 单元格的文本内容，不会自动推断数字类型。对于订单号、邮编或员工编号，这能保住前导零；只有接口明确要求数字时，才应在后续步骤转换类型。
空字段应该改成 null 吗？
不一定。空字符串、null 和缺少字段的含义由接口定义。先查字段说明，再对指定字段处理，不要对全部空值做同一种替换。
两个相同的标题会怎样？
同一个 JSON 对象不适合承载重复键，后面的同名值可能覆盖前面的值。请在转换前把标题改成唯一名称，并记录它们与接口字段的对应关系。
工具能验证生成的 JSON 一定能被 API 接收吗？
不能。它负责文本结构转换，不知道接口架构、鉴权、枚举值和业务规则。先做 JSON 语法检查，再用测试环境或官方校验方式确认。
可以直接上传含客户资料的订单 CSV 吗？
CSV JSON 互转工具没有文件上传入口，只处理粘贴文本。即使在浏览器中处理，也应遵守组织的数据权限，只使用获准内容，并优先用脱敏的小样本验证流程。