UD5工具箱
准备工作
使用本工具前，请确保您具备以下条件：
- 一个现代浏览器（Chrome、Firefox、Edge、Safari均可，推荐使用最新版本）
- 一个CSV或TSV格式的数据文件
- 了解目标JSON数据的结构需求（是否需要类型推断、使用哪个字段作为键名等）
本工具完全免费，无需注册账号，无需安装任何软件。所有处理过程在浏览器本地完成，您的数据不会上传到任何服务器。
详细操作步骤
第一步：打开工具页面
在浏览器中访问CSV转JSON工具页面。页面加载完成后，您会看到一个简洁直观的操作界面：顶部是功能工具栏，包含表头开关、类型推断开关和输出模式选择；中间是文件导入区域；下方分为左右两个面板，左侧显示原始CSV数据预览，右侧显示转换后的JSON代码。
第二步：导入CSV数据
工具提供两种数据导入方式，您可以根据实际情况选择：
方式一：拖放文件 — 在文件导入区域按住鼠标左键，将CSV文件拖放到虚线框内后松开。工具会立即读取文件内容并开始解析转换。这种方式适合处理保存在本地的CSV文件，操作直观高效。
方式二：粘贴文本 — 如果您的CSV数据已经复制在剪贴板中（例如从Excel、邮件或文档中复制），可以直接在文本输入框中按Ctrl+V粘贴。粘贴后工具会自动检测数据格式并开始转换。这种方式适合处理少量数据或从网页中复制的表格内容。
第三步：配置转换选项
数据导入后，在执行转换前请根据需要配置以下选项：
首行作为表头 — 默认开启。如果CSV的第一行是列名（如name、age、email），保持开启状态，这些列名将作为JSON对象的属性键名。如果第一行就是数据（没有列名），请关闭此选项，系统会自动生成col_1、col_2等默认键名。
类型推断 — 默认开启。开启后，工具会自动将数值转换为数字类型、将true/false转换为布尔类型、将空值转换为null。如果需要保留所有值为字符串格式（例如电话号码、邮编等以0开头的数字），请关闭此选项。
输出模式 — 默认为格式化输出。格式化输出的JSON带有缩进和换行，便于阅读和调试。如果需要压缩体积（如用于网络传输），可以切换到压缩输出模式。
第四步：查看转换结果
配置完成后，转换结果会实时显示在右侧的JSON代码面板中。您可以：
预览JSON结构 — 检查JSON数据的结构是否符合预期，特别注意键名是否正确、数据类型是否准确、嵌套结构是否合理。
检查数据完整性 — 对比左右两个面板，确认所有CSV行都已被正确转换为JSON对象，没有数据遗漏或截断。
切换输出模式 — 如果需要不同的输出格式，点击输出模式切换按钮即可即时切换。切换后JSON代码会自动重新生成。
第五步：复制或下载JSON代码
确认转换结果满意后，您可以通过以下方式获取JSON代码：
复制代码 — 点击「复制代码」按钮，格式化或压缩的JSON代码会自动复制到系统剪贴板。您可以直接粘贴到代码编辑器、配置文件或API请求体中使用。
下载文件 — 点击「下载JSON」按钮，工具会生成一个.json文件供您保存。文件名默认基于原始CSV文件名生成，方便文件管理。
进阶技巧
处理嵌套数据结构
CSV是扁平的二维表格，不直接支持嵌套数据。如果您需要在JSON中表示嵌套结构（如地址信息包含省市区三级），可以在CSV中使用约定的列名命名规则（如address_province、address_city、address_district），转换为JSON后在代码中手动重组嵌套结构。或者考虑将多个相关CSV文件分别转换为JSON后通过脚本合并。
批量转换多个文件
如果需要将多个CSV文件转换为JSON格式，建议逐个文件处理。每次转换完成后复制或下载JSON代码，然后导入下一个文件。工具会在导入新文件时自动清除之前的解析结果，无需手动清空。对于结构相同的批量文件，可以先完成一次配置和验证，然后快速重复操作。
与下游工具集成
转换后的JSON代码可以直接用于多种下游工具和场景：粘贴到Postman的Body中作为API请求数据、导入到MongoDB的mongoimport命令中、作为JavaScript代码中const data = [ ] 的数据源、或者嵌入到JSON配置文件中供应用程序读取。
故障排除
JSON代码显示为空
如果导入CSV数据后JSON代码面板为空，最可能的原因是CSV文件格式不正确。请检查文件是否使用了统一的分隔符、每行的字段数是否一致、文件编码是否为UTF-8。如果CSV文件使用了制表符分隔，请确保文件中的分隔符确实制表符而不是空格。
数字被错误地转换为字符串
如果某些数字字段没有被类型推断正确识别，可能是因为这些数字包含前导零（如001）、后缀单位（如100元）或千位分隔符（如1,000）。这些格式的值不会被识别为数字类型。解决方法是在CSV中将这些字段格式化为纯数字格式（如去掉前导零和单位后缀），或者关闭类型推断让所有值保持字符串格式。
大文件导入后页面卡顿
如果导入超过一万行的CSV文件后页面出现卡顿，请尝试关闭浏览器中不必要的其他标签页以释放内存。同时建议将大文件拆分为多个较小的文件（每个文件5000行以内）分别处理，这样可以获得更好的响应速度和操作体验。
中文字段名出现异常
如果CSV的表头包含中文字段名且出现显示异常，请确认CSV文件使用UTF-8编码保存。GBK或GB2312编码的CSV文件可能导致中文字段名解析不正确。使用VS Code或Notepad++打开文件并另存为UTF-8编码即可解决此问题。