C#写入CSV时如何转义插值字符串字段内的分号

核心转义规则 #

符合RFC 4180标准的CSV转义逻辑（兼容Excel、Pandas、CsvHelper等绝大多数主流CSV解析工具）要求如下：

• 若单个字段内容包含列分隔符（当前场景为;）、换行符、双引号字符，必须给整个字段外层包裹半角双引号"
• 字段内部原本存在的半角双引号，需要替换为两个连续的半角双引号""做转义，完整保留原始内容，不会篡改数据
• 列分隔符前后不要加多余空格，否则部分解析器会将空格识别为字段内容的一部分，导致单元格首尾出现无意义空白字符

实现代码 #

首先封装通用的CSV字段转义方法，不需要删除字段内的分号：

private static string EscapeCsvField(string fieldValue)
{
    if (string.IsNullOrEmpty(fieldValue))
        return string.Empty;

    // 判断当前字段是否需要做转义包裹
    bool needEscape = fieldValue.Contains(';') 
        || fieldValue.Contains('"') 
        || fieldValue.Contains('\r') 
        || fieldValue.Contains('\n');
    
    if (!needEscape)
        return fieldValue;

    // 转义内部双引号，外层包裹双引号
    return $"\"{fieldValue.Replace("\"", "\"\"")}\"";
}

调整原有的写入逻辑，不要直接拼接未转义的插值字符串：

string firstCol = EscapeCsvField($"Security: {sec.ID}");
string secondCol = EscapeCsvField(sec.SecuritySerialNo?.ToString());
// 直接用分号拼接转义后的字段，不要在分号前后加多余空格
csvWriter.WriteLine($"{firstCol};{secondCol}");

效果说明 #

即使sec.ID字段内包含任意数量的分号、双引号或换行符，转义后外层的双引号会告诉CSV解析器：双引号包裹范围内的所有字符都属于当前字段内容，内部的分号不会被识别为列分隔符。解析器读取数据时会自动移除外层包裹的双引号，将转义的双引号还原为单个字符，最终拿到的单元格内容和原始数据完全一致，不会出现列错位，也不会丢失原始字段里的分号。

举个实际场景：若sec.ID值为001;admin"test，sec.SecuritySerialNo值为SN20240001，最终写入CSV的行内容为：

"Security: 001;admin""test";SN20240001

CSV解析器读取后，第一格内容为完整的Security: 001;admin"test，第二格内容为SN20240001，完全符合业务要求。

如果业务场景涉及大量CSV读写操作，可直接使用成熟的CSV处理类库，类库会自动覆盖所有转义边界场景，避免手动拼接出现的兼容问题。

内容的提问来源于stack exchange，提问作者roy