CSV 转 JSON 转换器

简介

CSV 转 JSON 转换器弥合了电子表格样式数据与结构化 JSON 之间的差距。无论您是将数据从 Excel 导入 Web 应用程序、准备数据库导出的 API 负载，还是转换配置文件，该工具都能精确灵活地处理转换。

与需要安装的命令行工具或将数据上传到服务器的在线服务不同，Toollect CSV 转 JSON 转换器完全在您的浏览器中运行。每次按键都会实时更新 JSON 输出，为您提供即时反馈。无需通过网络传输数据，兼顾速度和隐私。

凭借智能分隔符检测、类型推断、多种输出格式和实时预览表，该转换器能够处理使 CSV 转换令人沮丧的边缘情况：包含逗号的引用字段、多行值、不一致的列数等。

工作原理

该转换器通过为准确性和灵活性设计的多阶段管道处理您的 CSV 数据。

解析

该工具使用遵循 RFC 4180 约定的自定义解析器逐行读取您的 CSV 输入。它正确处理：

• 引用字段：用双引号括起来的字段可以包含分隔符、换行符和其他特殊字符
• 转义引号：字段内的双引号表示为两个连续的双引号（""）
• 空字段：连续的分隔符产生空字符串值
• 尾部空格：引号外的空格将被修剪以获得干净输出

分隔符检测

在自动检测模式下，该工具会分析数据的前几行，测试每个候选分隔符（逗号、制表符、分号），并选择产生最一致列数的分隔符。您可以随时手动覆盖检测到的分隔符。

类型推断

启用类型推断后，该工具会扫描每个值并转换识别的模式：

• 数字：整数和小数（42、3.14、-1.5、1e10）成为 JSON 数字
• 布尔值：true 和 false（不区分大小写）成为 JSON 布尔值
• Null：null（不区分大小写）成为 JSON null
• 字符串：其他所有内容保持为字符串

您还可以启用 JSON 值解析，它会尝试解析看起来像 JSON 对象或数组的字段。

输出格式

最终的 JSON 输出根据您选择的选项生成：

• 对象数组：每行成为一个以表头行值为键的对象（默认）
• 二维数组：输出为数组的数组，忽略表头行
• 按第一列键控：一个以每个数据行第一列值为键的对象

输出可以格式化（2 或 4 空格缩进）或压缩为单行。

使用方法

使用 Toollect CSV 转 JSON 转换器无需设置或注册。请按照以下步骤操作：

1. 打开工具 — 导航到 CSV 转 JSON 转换器页面。界面显示上传区域、输入文本区域、设置面板和输出区域。

2. 输入数据 — 将 CSV 文本直接粘贴到文本区域，或单击上传区域（或拖放 .csv 文件）加载文件。

3. 检查设置 — 该工具会自动检测分隔符，并默认启用表头和类型推断。根据您的数据调整这些设置：

   • 如果自动检测不正确，请选择不同的分隔符
   • 如果数据缺少表头行，请切换"首行为表头"
   • 禁用类型推断以将所有值保留为字符串

4. 预览解析的数据 — 单击"显示预览"查看解析后的 CSV 数据的表格视图。这有助于验证分隔符和表头设置是否正确。

5. 检查 JSON 输出 — JSON 输出会在您输入时自动更新。输出文本区域是只读的，以防止意外编辑。

6. 复制或下载 — 单击"复制"将 JSON 复制到剪贴板，或单击"下载 JSON"将其保存为 .json 文件。

教程

本教程演示如何将 Excel 导出的 CSV 文件转换为用于 Web 应用程序的 JSON 数组。

场景：您有一个跟踪产品库存的 Excel 电子表格，希望将其导入需要 JSON 的 Web 应用程序。

1. 从 Excel 导出 — 将您的电子表格保存为 CSV 文件。您应该得到类似以下内容：

Product Name, SKU, Price, In Stock, Category
Widget Pro, WDG-001, 29.99, true, Tools
Gadget X, GDG-002, 49.95, false, Electronics
Super Tool, SUP-003, 99.00, true, Tools
Accessory Pack, ACC-004, 14.99, true, Accessories

2. 打开 CSV 转 JSON 转换器，将 CSV 文件拖到上传区域。该工具加载文件，检测逗号分隔符，并立即转换数据。

3. 检查预览 — 单击"显示预览"查看表格表示。确认表头行已正确解析。

4. JSON 输出 显示为：

[
  {
    "Product Name": "Widget Pro",
    "SKU": "WDG-001",
    "Price": 29.99,
    "In Stock": true,
    "Category": "Tools"
  },
  {
    "Product Name": "Gadget X",
    "SKU": "GDG-002",
    "Price": 49.95,
    "In Stock": false,
    "Category": "Electronics"
  },
  {
    "Product Name": "Super Tool",
    "SKU": "SUP-003",
    "Price": 99,
    "Category": "Tools"
  },
  {
    "Product Name": "Accessory Pack",
    "SKU": "ACC-004",
    "Price": 14.99,
    "In Stock": true,
    "Category": "Accessories"
  }
]

注意 Price 值是数字（不是字符串），In Stock 值是布尔值，并且"Super Tool"缺少"In Stock"值被省略。

5. 尝试键转换 — 从键大小写下拉菜单中选择"snake_case"。输出变为：

[
  {
    "product_name": "Widget Pro",
    "sku": "WDG-001",
    "price": 29.99,
    "in_stock": true,
    "category": "Tools"
  }
]

6. 尝试键控格式 — 选择"按第一列键控"以获取按产品名称索引的对象：

{
  "Widget Pro": {
    "SKU": "WDG-001",
    "Price": 29.99,
    "In Stock": true,
    "Category": "Tools"
  },
  "Gadget X": { ... }
}

7. 下载结果 — 单击"下载 JSON"将输出保存为 .json 文件，供 Web 应用程序使用。

专业提示

掌握这些技巧，充分利用 Toollect CSV 转 JSON 转换器：

• 先使用预览：在依赖 JSON 输出之前，始终检查预览表。列不匹配、错误的分隔符或编码问题在表格预览中立即可见

• 处理前导零：邮政编码、电话号码和 ID 通常有前导零。禁用类型推断以将它们保留为字符串——否则 00123 会变成数字 123

• 标准化列名：使用键大小写设置将不一致的表头转换为统一格式。对于 API 集成，通常首选 camelCase 或 snake_case

• 先清理 CSV：删除尾部空行，检查各行的列数是否一致，并确保引用字段使用双引号以获得最佳效果

• 与其他工具结合：在此处将 CSV 转换为 JSON，然后使用 JSON 格式化器验证和检查结构

替代方案

虽然 Toollect CSV 转 JSON 转换器提供了全面的功能集，但针对不同的使用场景也存在多种替代方案。

对于大多数需要快速、私密且功能丰富的 CSV 转 JSON 转换而又不想离开浏览器的用户来说，Toollect 转换器提供了功能性和便利性的最佳平衡。

故障排除

技术规格

性能基准

技术细节

• 解析器：自定义 RFC 4180 兼容 CSV 解析器，支持完整的引号/转义处理
• 类型推断：基于正则表达式检测数字、布尔值、null 值
• 分隔符检测：对前 10 行进行启发式评分，测试逗号/制表符/分号
• 输出引擎：原生 JSON.stringify()，支持可配置缩进
• 文件处理：FileReader API，10MB 大小限制
• 剪贴板：navigator.clipboard.writeText()，带 2 秒反馈指示器
• 下载：Blob + URL.createObjectURL() 用于内存中文件生成

浏览器兼容性

隐私与安全

• 零数据传输：所有 CSV 处理均在浏览器内存中进行
• 文件上传通过 FileReader API 在本地读取，从不传输
• 不使用 cookie、localStorage 或 sessionStorage
• 工具页面上没有分析或跟踪脚本
• 无需注册、登录或 API 密钥

功能特色

• 即时 CSV 转 JSON 转换，实时预览
• 智能分隔符自动检测，支持手动覆盖
• 数字、布尔值和 null 值的类型推断
• 多种输出格式：对象数组、二维数组和键控对象
• 键大小写转换（camelCase、snake_case、lowercase、UPPERCASE、Capitalize）
• 可折叠数据预览，在转换前验证您的 CSV

常见问题