CSV文件多余空列处理问题：如何按对象模型读取指定列

针对从Excel导出的CSV文件存在可变数量空列、空行的情况，以下提供两种C#实现方案，确保仅按Address类定义读取指定列，自动忽略多余内容。

方案一：使用CsvHelper库（推荐） #

CsvHelper是C#生态中成熟的CSV处理库，能轻松处理列映射、忽略多余列和过滤空行的需求。

1. 安装依赖 #

通过NuGet安装：

Install-Package CsvHelper

或使用.NET CLI：

dotnet add package CsvHelper

2. 实现代码 #

using CsvHelper;
using CsvHelper.Configuration;
using System.Globalization;
using System.IO;
using System.Linq;

// 定义目标对象模型
public class Address
{
    public string Name { get; set; }
    public string Street { get; set; }
    public string City { get; set; }
    public string State { get; set; }
    public string Zip { get; set; }
}

// 配置列映射规则
public class AddressMap : ClassMap<Address>
{
    public AddressMap()
    {
        // 映射类属性到CSV表头
        Map(m => m.Name).Name("Name");
        Map(m => m.Street).Name("Street");
        Map(m => m.City).Name("City");
        Map(m => m.State).Name("State");
        Map(m => m.Zip).Name("Zip");
        // 核心配置：忽略所有未映射的列
        IgnoreOtherProperties();
    }
}

// 读取有效数据的方法
public List<Address> ReadValidAddresses(string filePath)
{
    var csvConfig = new CsvConfiguration(CultureInfo.InvariantCulture)
    {
        // 处理表头可能存在的空格（如示例中的" Street"）
        PrepareHeaderForMatch = args => args.Header.Trim(),
        // 过滤完全空的行
        ShouldSkipRecord = args => args.Row.All(field => string.IsNullOrWhiteSpace(field))
    };

    using var reader = new StreamReader(filePath);
    using var csv = new CsvReader(reader, csvConfig);
    csv.Context.RegisterClassMap<AddressMap>();

    // 返回所有有效数据行的对象列表
    return csv.GetRecords<Address>().ToList();
}

关键配置说明 #

• IgnoreOtherProperties()：强制CsvHelper忽略类中未定义的所有列，无论多余列数量多少都不会抛出映射错误。
• PrepareHeaderForMatch：自动去除表头列名的空格，确保与类属性名正确匹配。
• ShouldSkipRecord：跳过所有字段均为空的行，只保留有效数据行。

方案二：手动解析CSV（无依赖） #

若不想引入第三方库，可手动实现CSV解析逻辑，精准提取目标列。

实现代码 #

using System.Collections.Generic;
using System.IO;
using System.Linq;

public class Address
{
    public string Name { get; set; }
    public string Street { get; set; }
    public string City { get; set; }
    public string State { get; set; }
    public string Zip { get; set; }
}

public List<Address> ReadCsvManually(string filePath)
{
    var addresses = new List<Address>();
    // 读取所有行并过滤空行
    var validLines = File.ReadAllLines(filePath)
                         .Where(line => !string.IsNullOrWhiteSpace(line) && !line.All(c => c == ','))
                         .ToList();

    if (validLines.Count == 0) return addresses;

    // 解析表头，获取目标列的索引
    var headers = validLines[0].Split(',').Select(header => header.Trim()).ToList();
    var columnIndices = new Dictionary<string, int>
    {
        {"Name", headers.IndexOf("Name")},
        {"Street", headers.IndexOf("Street")},
        {"City", headers.IndexOf("City")},
        {"State", headers.IndexOf("State")},
        {"Zip", headers.IndexOf("Zip")}
    };

    // 处理数据行
    foreach (var line in validLines.Skip(1))
    {
        var fields = line.Split(',').Select(field => field.Trim()).ToList();
        // 跳过无有效数据的行
        if (!fields.Any(f => !string.IsNullOrWhiteSpace(f))) continue;

        var address = new Address
        {
            Name = GetFieldValue(fields, columnIndices["Name"]),
            Street = GetFieldValue(fields, columnIndices["Street"]),
            City = GetFieldValue(fields, columnIndices["City"]),
            State = GetFieldValue(fields, columnIndices["State"]),
            Zip = GetFieldValue(fields, columnIndices["Zip"])
        };
        addresses.Add(address);
    }

    return addresses;
}

// 辅助方法：安全获取指定索引的字段值
private string GetFieldValue(List<string> fields, int index)
{
    return index >= 0 && index < fields.Count ? fields[index] : null;
}

逻辑说明 #

1. 先读取所有行，过滤掉完全空的行。
2. 解析表头，记录目标列的索引位置。
3. 逐行处理数据，仅提取目标索引对应的字段值，忽略多余列。
4. 跳过无有效数据的行，最终返回有效对象列表。

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