LOCALSHIFT 使用指南

处理 CSV 中的逗号、引号和换行

发布与审核日期 2026 年 10 月 12 日 · 基于 LocalShift 当前实现

单元格内含逗号或换行时，需要按 CSV 规则使用引号包裹。引号内的双引号须写成两个双引号。应使用解析器处理，而不能遇到逗号就拆分文本。

简单拆分容易出错的三种情况

地址可能包含逗号，备注可能包含换行，引用内容可能包含引号。这些都可能是字段内容，而非记录或列的分界。RFC 4180 说明了常见的 CSV 引号规则，但不同软件的实现仍可能存在差异。

示例中每条记录都有两列，即使其中一条备注在文本中占了两行。可将其粘贴到 CSV 转 JSON 工具，检查生成的字符串。

name,note
Alex,"hello, world"
Sam,"He said ""yes"""
Lee,"line 1
line 2"

如果文件使用分号分隔字段，请选择“分号”。在分号分隔的文件中，作为标点出现的逗号不是列分隔符。LocalShift 的 CSV 工具也支持竖线分隔符。

TSV 的分隔符是实际的制表符。输入反斜杠和字母 t，并不等于在文件中插入制表符。

各行字段数不一致时，请先检查分隔符和未闭合的引号。随意添加逗号来凑齐列数，可能将值移到错误的列中。

启用表头时，列名不能为空且不能重复。如果第一行是数据而非表头，请关闭表头选项；此时 CSV 转 JSON 会输出值数组。会跳过仅含空白的行。

CSV 转 TSV 会先解析单元格，再更换分隔符，因此引号内的逗号会作为原值的一部分保留。如果输出字段含制表符或换行，仍可能需要引号。请确认接收方支持这种写法。

如果输出将用于电子表格，请检查类似公式的单元格和“电子表格安全模式”选项。保留未经修改的源文件，便于转换后核对重要记录。

以下为通用格式参考资料；LocalShift 的具体行为另有说明和测试。