C# | 超简单CSV表格读写操作（轻松将数据保存到CSV，并支持读取还原）

一、上位机开发中的CSV应用背景

在工业自动化上位机开发中，CSV格式数据的生成与解析是常见的核心需求：

1. 用于设备运行数据的长期记录
2. 实现与其他系统（如MES/ERP）的数据交换
3. 生成可人工查阅的生产报表
4. 调试阶段数据快照保存

传统方式通过硬编码拼接字符串效率低下，且难以处理复杂数据结构。本文将讲解如何使用CsvSerializer类轻松实现CSV文件的生成和读取。

---

二、CSV读写实战教学

1. 基本对象序列化

/// <summary>
/// 基本学生信息类
/// </summary>
public class SimpleStudent
{
    public int Id { get; set; }
    public string Name { get; set; }
}

var students = new List<SimpleStudent>
{
    new SimpleStudent { Id = 1001, Name = "张三" },
    new SimpleStudent { Id = 1002, Name = "李四" }
};

var csv = new CsvSerializer().ConvertToCsvLines(students);
File.WriteAllLines("simple_students.csv", csv);

2. 多数据类型处理

/// <summary>
/// 复合数据类型演示类
/// </summary>
public class DataTypeDemo
{
    public DateTime RecordTime { get; set; }   // 时间类型
    public float Temperature { get; set; }     // 精确数值
    public bool IsValid { get; set; }          // 布尔类型
}

var data = new DataTypeDemo
{
    RecordTime = DateTime.Now,
    Temperature = 25.36f,
    IsValid = true
};

var serializer = new CsvSerializer();
File.WriteAllLines("data_types.csv", serializer.ConvertToCsvLines(new[] { data }));

3. 集合类型序列化

public class CollectionDemo
{
    public int[] SensorValues { get; set; }          // 整型数组
    public List<double> Voltages { get; set; }       // 泛型列表
}

var demo = new CollectionDemo
{
    SensorValues = new[] { 100, 200, 300 },
    Voltages = new List<double> { 3.3, 5.0, 12.0 }
};

// 生成CSV时集合元素自动以分号分隔
var csvLines = new CsvSerializer().ConvertToCsvLines(new[] { demo });

4. 二进制数据处理

public class BinaryData
{
    public byte[] ImageBuffer { get; set; }  // Base64编码存储
}

var data = new BinaryData
{
    ImageBuffer = File.ReadAllBytes("logo.png")
};

// 生成文件提示：大量二进制数据存入单行可能导致Excel无法打开
File.WriteAllLines("data_binary.csv", serializer.ConvertToCsvLines(new[] { data }));

5. 自定义类型支持

// 定义新的结构体类型
public struct Coordinate
{
    public double X;
    public double Y;
}

// 测试类型
public class CustomTypeDemo 
{ 
	public Coordinate Position { get; set; } 
}

// 注册自定义转换器
var serializer = new CsvSerializer();
serializer.Converters.Add(typeof(Coordinate), new StringConverter<Coordinate>(
    str =>
    {
        var parts = str.Split('|');
        return new Coordinate { X = double.Parse(parts[0]), Y = double.Parse(parts[1]) };
    },
    c => $"{c.X}|{c.Y}"
));

6. 表头自定义

public class MachineData
{
    [CsvColumn("Current Speed (m/min)")]
    public double Speed { get; set; }

    [CsvColumn("Working Temp (°C)")]
    public double Temperature { get; set; }
}

// 生成的CSV标题类似：
// Current Speed (m/min),Working Temp (°C)

7. 属性忽略

public class SecurityData
{
    public string PublicInfo { get; set; }

    [CsvIgnore]
    public string SecretKey { get; set; }  // 不会出现在CSV中
}

8. 大文件完整读写测试

生成用于测试的随机学生信息表CSV文件：

        /// <summary>
        /// 生成学生信息表
        /// </summary>
        public void GenerateTestCsvFile()
        {
            var serializer = new CsvSerializer();
            const int dataSize = 1000;

            var random = new Random();
            var students = Enumerable.Range(0, dataSize).Select(_ => GenerateRandomStudent(random)).ToList();

            var csv = serializer.ConvertToCsvLines(students);
            File.WriteAllLines("test_data.csv", csv);

            // 打开文件夹
            Process.Start("explorer.exe", "/select," + Path.GetFullPath("test_data.csv"));
            Console.WriteLine($"已生成测试数据文件：{Path.GetFullPath("test_data.csv")}");
        }

        /// <summary>
        /// 生成随机学生数据
        /// </summary>
        private static Student GenerateRandomStudent(Random random)
        {
            return new Student
            {
                // 基础类型
                Id = random.Next(10000, 99999),
                Name = $"Student_{random.Next(1, 1000)}",
                GPA = Math.Round(random.NextDouble() * 4.0, 2),

                // 结构体类型
                Location = new Point(random.Next(0, 100), random.Next(0, 100)),
                ClassSize = new Size(random.Next(30, 60), random.Next(20, 40)),

                // 集合类型
                Marks = Enumerable.Range(0, 5).Select(_ => random.Next(60, 100)).ToArray(),
                Courses = new List<string>
                {
                    $"Course_{random.Next(100, 999)}",
                    $"Course_{random.Next(100, 999)}",
                    $"Course_{random.Next(100, 999)}"
                },

                // 特殊类型
                Grade = (char)('A' + random.Next(0, 5))
            };
        }

        /// <summary>
        /// 测试用学生类（覆盖8种不同数据类型）
        /// </summary>
        private class Student
        {
            // 基础值类型
            public int Id { get; set; }

            // 字符串类型
            public string Name { get; set; }

            // 浮点类型
            public double GPA { get; set; }

            // 结构体类型（Point）
            public Point Location { get; set; }

            // 结构体类型（Size）
            public Size ClassSize { get; set; }

            // 数组类型
            public int[] Marks { get; set; }

            // 泛型集合
            public List<string> Courses { get; set; }

            // 字符类型
            public char Grade { get; set; }
        }

读取CSV文件，还原成对象数组：

// 读取还原数据
var serializer = new CsvSerializer();
var loadedData = serializer.ConvertFromCsvLines<Student>(File.ReadAllLines("test_data.csv"));

---

三、安装部署指南

通过NuGet包管理器安装：

通过NuGet包管理器执行：

Install-Package STTech.CodePlus

或使用.NET CLI：

dotnet add package STTech.CodePlus

---

四、感谢阅读

感谢各位读者耐心阅读，本库将持续迭代工业领域实用组件。如有建议可评论区留言，期待您的使用反馈！