如何在C#中创建带BOM的UTF-8格式CSV文件？

我原本用以下代码生成UTF-8无BOM格式的CSV文件：

static void Main(string args[])
{
    using (var streamWriter = new StreamWriter("D:\\path\\outputcsv"))
    {
        using (var csvWriter = new CsvWriter(streamWriter, CultureInfo.InvariantCulture))
        {
            // 写入逻辑
        }
    }
}

公司要求生成UTF-8 with BOM格式的CSV，我尝试修改代码但无法正常运行：

static void Main(string args[])
{
    using (var streamWriter = new StreamWriter("D:\\path\\outputcsv", false, UTF8Encoding(false))
    {
        using (var csvWriter = new CsvWriter(streamWriter, CultureInfo.InvariantCulture))
        {
            // 写入逻辑
        }
    }
}

调整后又出现以下错误：

• 无法将字符串转换为System.IO.Stream（文件路径处）
• 无法将bool类型转换为System.Text.Encoding
• 当前上下文中不存在名称“utf-8 encoding”

修正错误后改为以下代码，但生成的文件在记事本中仍显示为普通UTF-8（无BOM）：

using (var streamWriter = new StreamWriter("D:\\path\\Output.csv", true, System.Text.Encoding.UTF8))
{
    // 写入逻辑
}

求解决方法。

问题出在两个核心点：

1. 追加模式阻止BOM写入：你设置了append=true（第二个参数为true），在追加模式下，StreamWriter不会写入编码预编码（即BOM）——因为BOM只能放在文件开头，追加时不能插入到已有内容之前。
2. 编码实例的明确控制：虽然System.Text.Encoding.UTF8本身支持BOM，但追加模式会抑制其写入；直接创建UTF8Encoding实例并指定参数，能更明确地控制BOM的生成。

正确代码写法：

static void Main(string args[])
{
    // 创建带BOM的UTF-8编码实例
    var utf8WithBom = new System.Text.UTF8Encoding(true);
    // 使用覆盖模式（append=false），确保BOM写入文件开头
    using (var streamWriter = new StreamWriter("D:\\path\\Output.csv", false, utf8WithBom))
    {
        using (var csvWriter = new CsvWriter(streamWriter, CultureInfo.InvariantCulture))
        {
            // 示例写入逻辑
            csvWriter.WriteField("列1");
            csvWriter.WriteField("列2");
            csvWriter.NextRecord();
            csvWriter.WriteField("数据1");
            csvWriter.WriteField("数据2");
        }
    }
}

关键说明： #

• new UTF8Encoding(true)：参数true指定生成带BOM的UTF-8编码实例，其GetPreamble()方法会返回3字节的UTF-8 BOM。
• append=false：以覆盖模式创建新文件，此时StreamWriter会自动将BOM写入文件开头。
• 若需追加内容到已有带BOM的UTF-8文件，只需第一次创建文件时写入BOM，后续追加保持append=true即可，无需重复写入BOM。

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