如何格式化 CSV：设置分隔符、引号和输出模式

先了解它能做什么

CSV Formatter 用于把 CSV 文本按指定规则重新格式化。你可以调整字段分隔符、包围字段的引号字符，以及格式化模式，适合在整理文本、检查字段数量或准备进一步处理前，先统一 CSV 的输出形式。默认设置使用逗号作为分隔符、双引号作为引号字符，并采用 pretty 格式化。

按设置格式化 CSV

1. 准备 CSV 文本，并粘贴到输入区域。空白或只有空格的内容也可以提交，但结果会是空的格式化内容，行数和列数均为 0。
2. 根据原始文本选择字段分隔符，例如逗号；再选择所需的引号字符。若输入使用的分隔符不是逗号，应将设置改为实际使用的字符。
3. 选择格式化模式。使用 minimal 时采用最少 CSV 引号；使用其他格式化值时，工具会对所有字段使用引号。
4. 执行格式化并查看输出。对于非空文本，工具会先按选定的分隔符和引号字符解析行，再用同一组设置重新写出 CSV。
5. 检查返回的行数、列数和错误描述。列数表示解析结果中观察到的最大行宽；如果处理发生异常，格式化内容为空，行数和列数为 0，同时会返回错误描述。

如何理解结果

格式化后的文本是根据所选分隔符和引号字符重新写出的 CSV，不应把它理解为对原文排版的原样保留。行数是解析出的行数，列数取解析过程中出现过的最大行宽，因此不同数据行的字段数量不同时，列数并不代表每一行都拥有相同字段数。

例如，两行、每行三个字段的逗号分隔文本会得到 2 行、3 列的计数。若选择 minimal，输出采用最少引号；若选择其他格式化值，则所有字段都会使用引号。提交空白输入时，成功响应仍会返回空内容和 0 行、0 列；发生异常时也会返回空内容和 0 行、0 列，但会附带错误描述。

使用示例

你需要检查一段包含姓名、城市和订单号的两行 CSV 文本，并确认解析出的字段数量。

将“姓名,城市,订单号”与“李明,北京,A1024”两行文本粘贴到输入区域，使用逗号作为分隔符和双引号作为引号字符，然后选择一种格式化模式并执行处理。

返回重新写出的 CSV 文本，并提供行数与列数；该输入应显示 2 行、3 列。选择的格式化模式还会决定字段是否采用最少引号或全字段引号。

使用限制

• 列数是解析结果中观察到的最大行宽，不表示每一行都具有相同数量的字段；工具的行为范围是解析并重新写出 CSV。

常见错误

• 如果输出为空且同时出现错误描述，可能是输入无法按当前分隔符或引号设置完成处理。请核对原始 CSV 实际使用的字符，再重新选择对应设置并提交。

常见问题

可以提交空白输入吗？

可以，但空白或只有空格的输入会返回空格式化内容，行数和列数均为 0。

如何控制 CSV 的引号方式？

可以。使用 minimal 时采用最少 CSV 引号；使用其他格式化值时，所有字段都会使用引号。

处理失败时，结果中的行数和列数代表什么？

如果处理发生异常，返回内容会为空，行数和列数为 0，并附带错误描述；请先检查分隔符和引号字符是否与输入一致。