c# 如何读写 csv 文件

用

TextFieldParser

读 CSV 更安全，别手写字符串分割

手动

Split(',')

"Beijing, China"

Microsoft.VisualBasic.FileIO.TextFieldParser

Microsoft.VisualBasic

常见错误：漏掉

SetDelimiters(",")

HasFieldsEnclosedInQuotes = true

parser.SetDelimiters(",")

"John ""The Boss"" Doe"

HasFieldsEnclosedInQuotes = true

parser.CommentTokens

parser.TextFieldType

using Microsoft.VisualBasic.FileIO;
// ...
using (var parser = new TextFieldParser("data.csv"))
{
    parser.SetDelimiters(",");
    parser.HasFieldsEnclosedInQuotes = true;
    while (!parser.EndOfData)
    {
        string[] fields = parser.ReadFields();
        Console.WriteLine(string.Join("|", fields));
    }
}

写 CSV 用

StreamWriter

+ 手动转义，别直接

WriteLine

没有内置“一键写 CSV”的 API。直接

sw.WriteLine(string.Join(",", values))

,

"

\n

"

""

性能提示：不要为每行都新建

StreamWriter

Encoding.Default

Encoding.UTF8

using (var sw = new StreamWriter("output.csv", false, Encoding.UTF8))
{
    foreach (var row in data)
    {
        var escaped = row.Select(field =>
        {
            if (string.IsNullOrEmpty(field) || field.IndexOfAny(new char[] { ',', '"', '\n', '\r' }) == -1)
                return field;
            return $"\"{field.Replace("\"", "\"\"")}\"";
        });
        sw.WriteLine(string.Join(",", escaped));
    }
}

第三方库选

CsvHelper

，但注意配置陷阱

CsvHelper

典型问题：用

GetRecords<t>()</t>

ShouldQuote

csv.Configuration.Delimiter = ","

csv.Configuration.HasHeaderRecord = true

new StreamWriter("out.csv", false, Encoding.UTF8)

CsvWriter

csv.Configuration.ShouldQuote = args => true

Excel 打不开 CSV？大概率是编码或 BOM 问题

Windows 上 Excel 默认用系统本地编码（如 GB2312）打开 CSV，UTF-8 无 BOM 的文件常显示乱码。这不是 CSV 格式错，而是编码声明缺失。

解决方法只有两个：要么保存为 UTF-8 with BOM，要么改用 ANSI 编码（不推荐，中文易损）。

new UTF8Encoding(true)

true

Encoding.UTF8

var bomUtf8 = new UTF8Encoding(true); // 注意这个 true
using (var sw = new StreamWriter("excel-friendly.csv", false, bomUtf8))
{
    // ... 写内容
}

BOM 和字段转义是绝大多数人卡住的地方，不是语法不会，是不知道 Excel 和 RFC 对“合法 CSV”的要求比直觉严格得多。