# JSON 转 CSV：列、嵌套值、引号与公式安全

> 转换器如何由对象数组生成表格：列的并集与顺序、嵌套值作为 JSON 文本、引号规则、LF 换行、哪些输入会被拒绝，以及它不防范的电子表格公式风险。

- Tool: [JSON 转 CSV 转换器](https://toolsg.com/zh/json-to-csv)
- 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.

## 关键数字一览

| 项目 | 数值 | 来源 |
| --- | --- | --- |
| 接受的输入 | 对象数组，或单个对象 — 标量、标量数组、数组的数组和含 null 的数组都会被拒绝。 |  |
| 列 | 所有键的并集，按首次出现的顺序 — 缺少某个键的记录，该单元格为空。 |  |
| 嵌套值 | 以紧凑的 JSON 文本写入一个单元格 — 对象和数组不会被展开成额外的列。 |  |
| 换行符 | LF，末尾没有换行 — RFC 4180 规定用 CRLF；大多数工具读 LF 没有问题。 | [IETF — RFC 4180](https://www.rfc-editor.org/rfc/rfc4180.html) |

## 输入与输出

粘贴 JSON 后，右侧框显示 CSV，并随输入实时更新。有输出时会出现下载链接（`converted.csv`）。不会上传任何内容。

输入必须是对象数组，或单个对象（当作只有一行的表格）。输出的第一行是表头。示例：`[{"name":"Mei","city":"Singapore","age":30},{"name":"Ali","city":"Johor","age":25}]` 得到

```
name,city,age
Mei,Singapore,30
Ali,Johor,25
```

其他输入，如 `5`、`"text"`、`null`、`[1,2]`、`[[1,2]]` 或 `[{"a":1},null]`，都会中止并提示“只有对象数组（或单个对象）才能转换为表格。嵌套数组没有可以映射的行和列。”空数组 `[]` 得到空输出。

## 列与缺失的键

表头是所有记录中全部键的并集，顺序为每个键首次出现的顺序。缺少某个键的记录，该单元格为空：

| 输入 | 输出 |
| --- | --- |
| `[{"a":1,"b":2},{"b":3,"c":4}]` | `a,b,c` / `1,2,` / `,3,4` |
| `[{"b":1,"2":2,"1":3}]` | `1,2,b` / `3,2,1`（整数形式的键排在最前） |

因为 JavaScript 会把整数形式的键排在最前，所以 `{"b":1,"2":2,"1":3}` 这样的记录无论文本中顺序如何，都会读成 `1, 2, b`。`{}` 或 `[{}]` 只会得到一个换行。

## 单元格的值

| JSON 值 | 单元格 |
| --- | --- |
| 字符串 | 文本本身 |
| 数字 | 按 JavaScript 方式输出：`1.50` 变成 `1.5`；`12345678901234567890` 变成 `12345678901234567000`；`1e21` 变成 `1e+21`；`-0` 变成 `0` |
| `true` / `false` | `true` / `false` |
| `null` | 空单元格（与 `""` 无法区分） |
| 对象或数组 | 带引号的紧凑 JSON 文本：`[1,2]` 变成 `"[1,2]"`，`{"k":"v,w"}` 变成 `"{""k"":""v,w""}"` |

看起来像数字的字符串（`"007"`）不带任何标记地写出，所以电子表格打开时可能把它变成数字 7。那是电子表格的行为，文件本身无法阻止。

## 引号规则

只有字段含逗号、双引号、换行（LF）或回车（CR）时才会加双引号，内部的引号会加倍，这与 RFC 4180 的要求一致。表头名称遵循同样的规则：键 `a,b` 变成 `"a,b"`。首尾空格不会加引号，所以 `"  pad  "` 直接写出；RFC 4180 把空格视为字段的一部分。非 ASCII 文本（`é中🙂`）原样写出，下载的文件是不带字节顺序标记的 UTF-8。

## 电子表格公式注入

值是原样写出的。以 `=`、`+`、`-` 或 `@` 开头的单元格（例如 `=SUM(A1)`）在电子表格看来就是公式，OWASP 把这称为 CSV 注入。本工具不会给这类单元格加前缀或做任何处理。如果数据来自不可信的用户，而 CSV 又会在电子表格中打开，请自行先处理这些值（例如加上单引号前缀），并注意这样会改变数据。

> **提示：** 想把嵌套数据放进各列，请在转换前先展平，让 `{"address":{"city":"SG"}}` 变成 `{"address_city":"SG"}`。[JSON 转文本](https://toolsg.com/zh/json-to-text)能显示可作为列名的路径。

## 常见错误

- 传入的对象，其值才是记录（`{"a":{…},"b":{…}}`）：它会变成一行带 JSON 文本单元格的数据，而不是每个条目一行。
- 期待能区分 `null` 和 `""`。
- 在电子表格中打开含嵌套 JSON 单元格的 CSV，却期待得到分开的列。
- 把输出当成严格符合 RFC 4180：它用的是 LF，不是 CRLF。

## 相关工具

用 [CSV 转 JSON](https://toolsg.com/zh/csv-to-json)转回去，用 [JSON 转 TSV](https://toolsg.com/zh/json-to-tsv)生成制表符分隔的输出，用 [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: fields, quoting, line breaks, header.
- [IETF — RFC 8259, The JSON Data Interchange Format](https://www.rfc-editor.org/rfc/rfc8259.html)
- [OWASP — CSV Injection](https://community.owasp.org/attacks/CSV_Injection) — Cells starting with =, +, -, @, tab, CR or LF can be treated as formulas.
