使用CSVHelper为Blazor .NET 8应用的CSV数据实现自动递增ID列

一、修复RegisterClassMap报错 #

报错源于CSVHelper版本迭代后的配置逻辑变更：

• 若使用v27及以下版本，可直接调用config.RegisterClassMap<ArtworkMap>()注册映射
• 若使用v30+版本，映射需添加到CsvConfiguration的ClassMaps集合中，示例代码：

// 定义映射类
public class ArtworkMap : ClassMap<Artwork>
{
    public ArtworkMap()
    {
        Map(m => m.Id).Name("Id"); // 与CSV列名对应，属性名与列名一致可省略
        Map(m => m.Title).Name("Title");
        // 其他字段映射
    }
}

// v30+版本的映射配置写法
var config = new CsvConfiguration(CultureInfo.InvariantCulture)
{
    ClassMaps = { typeof(ArtworkMap) },
    // 追加数据时关闭表头写入，避免重复输出表头
    HasHeaderRecord = false
};

二、实现自动递增Id #

核心逻辑是读取现有CSV的最大Id，新增数据时赋值为maxId + 1，无需依赖映射即可实现：

1. 获取下一个Id的方法 #

private int GetNextArtworkId(string filePath)
{
    if (!File.Exists(filePath))
        return 1; // 文件不存在时从Id=1开始

    using var reader = new StreamReader(filePath);
    using var csvReader = new CsvReader(reader, CultureInfo.InvariantCulture);
    
    var records = csvReader.GetRecords<Artwork>().ToList();
    return records.Any() ? records.Max(r => r.Id) + 1 : 1;
}

2. 追加写入数据完整流程 #

var filePath = "your-artworks.csv";
var newArtwork = new Artwork
{
    Id = GetNextArtworkId(filePath),
    Title = "New Artwork",
    Artist = "Your Artist"
    // 其他字段赋值
};

// 首次写入文件时添加表头
if (!File.Exists(filePath))
{
    using var initWriter = new StreamWriter(filePath);
    using var initCsv = new CsvWriter(initWriter, CultureInfo.InvariantCulture);
    initCsv.WriteHeader<Artwork>();
    initCsv.NextRecord();
}

// 追加写入新数据
using var appendWriter = new StreamWriter(filePath, append: true);
using var appendCsv = new CsvWriter(appendWriter, config); // 使用之前配置好的config
appendCsv.WriteRecord(newArtwork);
appendCsv.Flush();

三、注意事项 #

• 若CSV文件体积较大，读取全部记录获取MaxId会影响性能，可改为逐行读取最后一条记录的Id，或单独维护一个存储当前最大Id的配置文件
• 多线程并发写入场景下需加锁，避免Id重复
• 确保Artwork类的Id字段为可赋值的公开属性（public int Id { get; set; }）

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