# 逗号分隔工具：行列表与逗号文本互转

> 多行如何变成逗号分隔列表（以及反向转换）、引号与转义如何工作（引号会重复两次，符合 CSV 和 SQL 的要求），以及它与真正的 CSV 解析器仍有哪些差距。

- Tool: [逗号分隔工具](https://toolsg.com/zh/comma-separator)
- Language: zh (available: en, zh, ms, ta)
- Last verified against official sources: 2026-10-20
- Source site: ToolSG — a planning guide, not official or financial advice. Cite the agencies listed under Sources.

## 关键数字一览

| 项目 | 数值 | 来源 |
| --- | --- | --- |
| 方向 | 按行转逗号分隔，或逗号分隔转按行 — 通过“方向”菜单选择。 |  |
| 连接符 | 逗号加一个空格 — 各项用 `, ` 连接；可选择在末尾加逗号。 |  |
| 引号转义 | 引号字符重复两次 — 单引号下 `it's` 变成 `'it''s'`，双引号下 `say "hi"` 变成 `"say ""hi"""`，符合 SQL 和 CSV 的要求。 |  |
| 逗号转按行 | 识别引号的拆分 — 带引号的字段里可以含逗号和重复的引号；`1,200` 仍会变成两项。 |  |

## 按行转为逗号分隔

默认方向下，工具在浏览器中对文本执行以下操作：

1. 拆成行（`\r\n`、`\r`、`\n`）。
2. 去掉每行两端的空白，丢弃空行。
3. 可选：给每一项加上单引号或双引号。
4. 用逗号加一个空格（`, `）连接。勾选“末尾加分隔符”会在最后加一个逗号。

项目内部的空格会保留：`a b c` 仍是一项。输入为空则结果为空。

示例输入，包含缩进的行、一个空行和 Windows 换行：

```
apple
  banana 
（空行）
cherry
it's
```

| 引号选项 | 输出 |
| --- | --- |
| 不加引号 | `apple, banana, cherry, it's` |
| 单引号 | `'apple', 'banana', 'cherry', 'it''s'` |
| 双引号，末尾加逗号 | `"apple", "banana", "cherry", "it's",` |

## 引号如何转义

开启引号时，工具会把项目内部与外层相同的引号字符重复两次：单引号下 `it's` 变成 `'it''s'`；双引号下 `say "hi"` 变成 `"say ""hi"""`。另一种引号不会被处理（双引号下 `it's` 仍是 `"it's"`），反斜杠也不会被改动（`back\slash` 保持 `back\slash`）。

这正是两种常见目标格式所要求的：

- **CSV。** RFC 4180 规定带引号字段内的双引号通过重复一次来转义：`"b""bb"`。在 CSV 中反斜杠只是普通字符。CSV 请使用双引号。
- **标准 SQL / PostgreSQL。** 字符串常量中的单引号写成两个单引号（`'it''s'`）。`standard_conforming_strings` 开启时（PostgreSQL 9.1 起默认开启），普通常量中的反斜杠是字面字符，因此 `'it\'s'` 这样的反斜杠转义会出错。SQL 请使用单引号。

> **提示：** 这个工具适合 ID、标签、电子邮件地址等简单值的列表。对于来自用户的值，不要把结果直接粘贴进 SQL 或 CSV。请使用数据库的参数化查询或 CSV 库，它们还能防止注入。

## 逗号分隔转为按行

选择另一个方向会做相反的事：

1. 逐个字符扫描文本，在每个逗号处拆分，但引号内除外：以单引号或双引号开头（前面可有空格）的片段会一直读到对应的结束引号，所以其中的逗号不会拆分它。
2. 带引号的片段里，连续两个引号字符变成一个字面引号，所以 `"say ""hi"""` 得到 `say "hi"`。
3. 去掉不带引号片段两端的空白，丢弃空段，用换行连接。
4. 如果引号打开后一直没有关闭，则改为在每个普通逗号处拆分整个文本，并去掉每段两端的引号字符，这样一个孤立的撇号（如 `'tis`）不会吞掉列表的其余部分。

示例：

| 输入 | 输出 |
| --- | --- |
| `a, b,,'c', "d" ,e` | `a`、`b`、`c`、`d`、`e` 各占一行 |
| `'it''s', "x, y", z` | `it's`、`x, y`、`z` |
| `"say ""hi""", "ok"` | `say "hi"`、`ok` |
| `1,200, 3,400` | `1`、`200`、`3`、`400` |
| `a;b` | `a;b`（只有逗号会拆分） |
| `'tis, fine` | `tis`、`fine`（未关闭的引号被忽略） |

它仍然不是完整的 CSV 解析器：单引号也被当作引号，只有 ASCII 逗号才会分隔项目，带引号字段里的换行会变成两行，带千位分隔符的数字也会被拆开。处理真正的 CSV 文件请使用电子表格或专门的解析器。

## 常见错误

- 把结果粘贴进用不可信的值构造的 SQL 查询。这些引号是合法的 SQL，但参数化查询仍然是安全的做法。
- 把双引号用于 SQL：SQL 字符串常量使用单引号，双引号适合 CSV。
- 以为分隔符只是逗号。连接符是逗号加空格，如果格式需要 `a,b,c`，请事后删掉空格。
- 忘了空行会被丢弃，所以空白行不会变成列表中的空项。

## 相关工具

[文本排序工具](https://toolsg.com/zh/text-sorter)可在连接前排序并去重。[移除换行符](https://toolsg.com/zh/remove-line-breaks)用空格而不是逗号连接各行。[文本重复器](https://toolsg.com/zh/text-repeater)可快速生成重复的列表。[字数统计工具](https://toolsg.com/zh/word-counter)统计列表的行数和字数。

## 常见问题

**我的文本会被发送到服务器吗？**

不会。所有处理都通过 JavaScript 在您的浏览器中完成。您输入或粘贴的内容不会被上传、记录或存储在任何地方。

**有长度限制吗？**

没有固定限制——实际上限取决于您浏览器的内存。数万字的文档也能轻松处理。

**支持非英文文本吗？**

支持，任何语言的文本都会原样保留。工具只按英文逗号（,）拆分，所以中文逗号（，）和顿号（、）不会被当作分隔符。

**它会改动我的原始文本吗？**

不会。您的输入会保持原样；结果单独生成，方便您调整选项并对比。


## 资料来源

- [RFC 4180 — Common Format and MIME Type for CSV Files](https://www.rfc-editor.org/rfc/rfc4180#section-2) — Quotes inside quoted fields are escaped by doubling.
- [PostgreSQL — String constants](https://www.postgresql.org/docs/current/sql-syntax-lexical.html) — A single quote in a string constant is written as two single quotes; backslashes are literal by default.
