C#导出List为CSV方法分享

推荐使用CsvHelper库导出List为CSV文件，它自动处理特殊字符转义、UTF-8编码（可选BOM）、表头生成及类型映射；若轻量需求，可用StringBuilder手动拼接并实现EscapeCsvField方法进行合规转义。

用C#把List导出为CSV文件，核心是把对象属性按逗号分隔、换行写入文本文件，注意处理特殊字符（如逗号、换行、双引号）并正确转义。下面提供几种实用、安全、易用的方法。

使用StringBuilder手动拼接（轻量可控）

适合结构简单、性能要求不高或需精细控制格式的场景。关键点：字段含逗号、双引号或换行符时，必须用双引号包裹；字段内有双引号要替换成两个双引号。

• 先获取泛型List的属性名作为表头
• 遍历每个对象，对每个属性值做CSV转义（封装成EscapeCsvField方法）
• 用StreamWriter写入文件，指定UTF8编码（带BOM可选，避免中文乱码）

用System.Text.Json + 自定义序列化（现代简洁）

如果List元素是简单POCO（无嵌套/复杂类型），可先用JsonSerializer序列化为JSON，再转成CSV——但更推荐直接手写CSV逻辑。真正推荐的是用CsvHelper库（NuGet安装CsvHelper），它专为CSV设计，自动处理转义、类型映射、头部、编码等细节：

• 创建CsvWriter绑定StreamWriter（UTF8编码）
• 调用WriteRecords(list)一行导出全部数据
• 支持自定义映射（如忽略属性、重命名列、格式化日期）

处理中文与编码问题（避坑重点）

Windows记事本默认用ANSI打开CSV，中文会乱码。解决方案：写入时加UTF-8 BOM头（\uFEFF），或保存为UTF-8无BOM+用Excel/VS Code等工具打开。

• 用new StreamWriter(path, false, new UTF8Encoding(true)) —— true表示写BOM
• 不加BOM时，建议用Excel 2016+“数据→从文本/CSV”导入，并手动选UTF-8编码
• 避免用File.WriteAllText，它默认用UTF-8无BOM，且不支持流式写入大文件

导出含特殊字符的字符串字段（关键细节）

CSV规范规定：只要字段含逗号、换行符（\n\r）、双引号（"），就必须用双引号包裹；字段内双引号需转义为""（两个连续双引号）。

示例转义方法：

static string EscapeCsvField(string field) =>
    field == null ? "" : field.Contains(",") || field.Contains("\"") || field.Contains("\n") || field.Contains("\r")
        ? $"\"{field.Replace("\"", "\"\"")}\""
        : field;

基本上就这些。小项目用StringBuilder+手动转义足够；中大型项目直接上CsvHelper，省心又健壮。