推荐使用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,省心又健壮。










