# CSV 转 JSON：解析规则、字符串值与长短不一的行

> 本转换器如何读取 CSV（仅逗号、首行为表头、按 RFC 4180 处理引号并略有宽松），为什么每个值都是字符串，以及行过短、过长、表头重复和字节顺序标记时会怎样。

- Tool: [CSV 转 JSON 转换器](https://toolsg.com/zh/csv-to-json)
- Language: zh (available: en, zh, ms, ta)
- Last verified against official sources: 2026-10-19
- Source site: ToolSG — a planning guide, not official or financial advice. Cite the agencies listed under Sources.

## 关键数字一览

| 项目 | 数值 | 来源 |
| --- | --- | --- |
| 分隔符 | 仅逗号 — 用分号分隔的文件不会被拆开；每一行成为一列。 | [IETF — RFC 4180](https://www.rfc-editor.org/rfc/rfc4180.html) |
| 表头行 | 始终是第一行 — 它的单元格成为每条记录的 JSON 键；不能关闭表头。 |  |
| 值的类型 | 每个值都是字符串 — 30 变成 "30"，007 仍是 "007"，12.50 仍是 "12.50"。 |  |
| 带引号的字段 | 引号内的逗号、换行和 "" 都能正确读取 — 引号只在字段开头才会开启带引号字段。 |  |

## 转换器做什么

粘贴 CSV 后，右侧框显示一个 JSON 数组，每个数据行对应一个对象，用两个空格缩进。它随输入实时更新，不会上传任何内容，有输出时会出现下载链接（`converted.json`）。只含空白的输入得到空输出。

示例输入 `name,city,age` / `Mei,Singapore,30` / `Ali,Johor,25` 得到：

```json
[
  { "name": "Mei", "city": "Singapore", "age": "30" },
  { "name": "Ali", "city": "Johor", "age": "25" }
]
```

（页面会把每个对象展开成多行。）注意 `"30"`：数字、布尔值和空单元格全部是字符串，因为 CSV 本身没有类型。所以前导零和末尾小数得以保留（`007`、`12.50`），`1e3` 或 `0x1F` 这样的值也不会被解释。需要数字时，请在你自己的代码里用 `Number(value)` 转换。

## 解析规则

RFC 4180 只是一份信息性备忘录，不是标准，现实中的文件常常偏离它。本解析器遵循其主要规则，并在几处更宽松：

- 记录以换行结束。CRLF、单独的 CR 和 LF 都接受；末尾的一个换行不会产生空行。引号内的换行会保留并规范成 `\n`。
- 只有字段的第一个字符是 `"` 时才算带引号字段。引号内，`""` 是一个字面引号，逗号和换行都是字面内容。
- 不带引号字段中间的引号会当作文本保留：`x"y` 得到 `x"y`。RFC 4180 不允许这样，但很多导出程序会产生。
- 闭合引号之后的字符会被追加：`"x"y` 得到 `xy`。
- 引号未闭合时转换会中止，并提示“有一个带引号的字段没有闭合——请检查多余的双引号。”
- 空格属于字段的一部分。`a, b` 得到键 `" b"`，`" 1 "` 保留其空格；不做任何修剪。

## 长短不一的行、表头与空行

| 输入 | 结果 |
| --- | --- |
| 单元格较少的行（`a,b` 下一行 `1`） | 缺少的单元格变成 `""` |
| 单元格较多的行（`a,b` 下的 `1,2,3`） | 多余的单元格被静默丢弃 |
| 重复的表头（`a,a` 下一行 `1,2`） | 后面的列覆盖前面的：`{"a":"2"}` |
| 空表头单元格（`,b`） | 键为 `column_1`（按位置） |
| 行与行之间的空行 | 一条值全为 `""` 的记录 |
| 只有表头行 | `[]` |
| 开头的 UTF-8 字节顺序标记 | 会保留：第一个键变成 `"﻿name"` |
| 用分号分隔的文件 | 只有一个键（`a;b`），整行内容是它的值 |

最后两行在实践中很重要。如果你的导出带字节顺序标记，粘贴前请先去掉，否则第一列的名称对不上。分号或制表符分隔的文件，请替换分隔符，或使用 [TSV 转 JSON](https://toolsg.com/zh/tsv-to-json)。

> **提示：** 转换后，检查一行同一单元格里同时含逗号、引号和换行的记录。这一行能完整通过，其余的也不会有问题。

## 常见错误

- 期待数字或 `null`：得到的是字符串，空单元格是 `""`。
- 粘贴的文件第一行是数据而不是表头；第一条记录会变成键。
- 没发现因为表头较短，多余的单元格被丢掉了。
- 依赖重复的列名；后面的会悄悄替换前面的。
- 以为页面会强制每行字段数相同。RFC 4180 要求每行字段数应当一致；本工具接受长短不一的行。

## 相关工具

用 [JSON 转 CSV](https://toolsg.com/zh/json-to-csv)转回去，用 [TSV 转 JSON](https://toolsg.com/zh/tsv-to-json)读取制表符分隔的数据，用 [JSON 验证器](https://toolsg.com/zh/json-validator)检查结果，或在 [JSON 查看器](https://toolsg.com/zh/json-viewer)中浏览。

## 常见问题

**我的数据会被上传吗？**

不会。转换完全在您的浏览器中通过 JavaScript 运行。您粘贴的内容不会离开您的设备，不会被记录，也不会存储在服务器上。

**可以处理多大的文档？**

限制取决于您浏览器的内存，而非服务器配额。几兆字节的文档可以顺利转换；极大的文件可能会让页面在处理时短暂无响应。

**嵌套数据会怎样处理？**

对于没有嵌套概念的格式，嵌套值会以 JSON 字符串的形式存入单元格，因此不会有内容被悄悄丢弃，结构也可以还原。

**能正确处理字段中的引号和逗号吗？**

可以。解析遵循 RFC 4180，因此包含逗号的带引号字段、转义的双引号，以及字段内部的换行都能被正确读写。


## 资料来源

- [IETF — RFC 4180, Common Format and MIME Type for CSV Files](https://www.rfc-editor.org/rfc/rfc4180.html) — Informational (not a standard): fields, quoting rules, optional header.
- [IETF — RFC 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html) — The JSON output.
