C#怎么将List导出为CSV文件 C#生成CSV文件方法-C#.Net教程-PHP中文网

C#怎么将List导出为CSV文件 C#生成CSV文件方法

幻夢星雲

发布： 2025-12-22 15:08:02

原创

469人浏览过

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

c#怎么将list导出为csv文件 c#生成csv文件方法

用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等工具打开。

星辰Agent

科大讯飞推出的智能体Agent开发平台，助力开发者快速搭建生产级智能体

404

查看详情

用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，省心又健壮。

以上就是C#怎么将List导出为CSV文件 C#生成CSV文件方法的详细内容，更多请关注php中文网其它相关文章！

大家都在看：

.NET怎么将查询结果导出为Excel文件 C# 如何读写 Excel 文件_C# Excel 文件读写操作指南 .NET怎么操作Excel文件的读取和写入_Excel文件读写操作方法 .NET怎么将查询结果导出为Excel文件_查询结果导出Excel教程如何用C#实现数据库数据的导入和导出？常用方法是什么？