CSV导出错列实测：逗号、双引号和换行应该怎样转义

导出一行数据时，直接 fields.join(',') 很容易产生错列。问题通常不在中文编码，而在字段本身含有分隔符。本文用一个小函数和六组用例，演示如何保留原始文本并生成 CSV 字段。

一、最小复现：内容里的逗号不是分隔符

设业务字段为 ["华为云", "a,b", "普通文本"]。直接拼接得到 华为云,a,b,普通文本，读入后第二个字段被拆开，三列变成四列。把整行统一加一对引号也不能解决问题，因为引号必须作用于每个需要转义的字段。

二、一个可直接运行的字段编码函数

function csvField(value) {
  const text = String(value);
  return /[",\r\n]/.test(text)
    ? '"' + text.replaceAll('"', '""') + '"'
    : text;
}
function csvRow(fields) {
  return fields.map(csvField).join(',');
}
console.log(csvRow(['华为云', 'a,b', '他说"好"', '']));
// 华为云,"a,b","他说""好""",

处理顺序是：先将字段内部的双引号替换为两个双引号，再用一对双引号包裹整个字段。字段包含逗号、回车或换行时也要包裹。原有空格直接保留，不调用 trim，也不把换行悄悄替换成空格。

三、六组实际运行结果

以下用例已在 JavaScript 环境实际运行，逐项比较实际值与期望值，六项均通过。表中 \n 表示字段内部的真实换行，用转义形式展示以便阅读。

csvRow(['A', '']) 的结果为 A,，末尾的逗号表示还有一个空字段，不能在输出后随手删除。空字符串和 null 的业务含义也要提前约定：这个函数会把 null 转成字符串 null，并不自动把它解释为空值；若业务需要空值映射，应在调用函数之前明确处理。

四、不要用 split 反向解析，也不要把格式转义当安全处理

带引号的字段可以包含逗号和真实换行，因此 line.split(',') 不是与上述编码函数配套的解析器；按换行切分全文同样会破坏多行字段。实际导入时应交给支持带引号字段的 CSV 解析器，并使用相同的分隔符约定。

另一个容易混淆的点是电子表格公式。给 =1+1 外面加双引号，并不意味着电子表格软件一定把它当普通文本。CSV 语法编码只负责格式，不负责公式防护。导出来自外部用户的文本时，应结合目标软件的文本导入选项及业务约定单独设计处理，不在通用转义函数里偷偷加单引号改变原始内容。

这段实现限定为逗号分隔的 CSV 字段与单行记录生成，不承担文件编码、BOM、日期转换、Excel 单元格格式设置或完整 CSV 解析的职责。将这些责任分开，定位“乱码”“错列”“数值被转换”时会更清楚。