MiniExcel快速上手：10个实用示例教你导入导出Excel

MiniExcel快速上手：10个实用示例教你导入导出Excel

【免费下载链接】MiniExcelFast, Low-Memory, Easy Excel .NET helper to import/export/template spreadsheet (support Linux, Mac)项目地址: https://gitcode.com/gh_mirrors/mi/MiniExcel

MiniExcel是一款轻量级的.NET Excel处理库，以其高效低内存的特性著称，支持在Linux、Mac等多平台上轻松实现Excel的导入、导出和模板操作。无论是处理小型数据表格还是大型数据集，MiniExcel都能提供快速且可靠的解决方案，帮助开发者轻松应对各种Excel操作需求。

一、环境准备：快速安装与配置

要开始使用MiniExcel，首先需要通过NuGet安装相关包。在项目中使用以下命令即可快速添加依赖：

Install-Package MiniExcel

如果使用.NET CLI，则执行：

dotnet add package MiniExcel

安装完成后，在代码中引入命名空间即可开始使用：

using MiniExcel;

二、核心功能示例：从基础到进阶

1. 简单导出：将列表数据写入Excel

MiniExcel提供了简洁的API，只需几行代码即可将集合数据导出为Excel文件：

var data = new List<object> { new { Name = "张三", Age = 25, Score = 90 }, new { Name = "李四", Age = 30, Score = 85 } }; data.ToExcel("output.xlsx");

这段代码会在当前目录生成一个包含人员信息的Excel文件，无需复杂配置，即可快速实现数据导出。

2. 导入数据：读取Excel内容到对象列表

读取Excel文件同样简单，MiniExcel支持将表格数据直接映射到实体类：

var rows = MiniExcel.Query<Person>("input.xlsx").ToList(); foreach (var row in rows) { Console.WriteLine($"Name: {row.Name}, Age: {row.Age}"); }

其中Person类需包含与Excel列名匹配的属性，MiniExcel会自动完成数据类型转换。

3. 大型文件处理：流式读写降低内存占用

处理百万级数据时，传统方式容易导致内存溢出。MiniExcel的流式处理功能可有效解决这一问题：

using (var stream = File.OpenWrite("large_data.xlsx")) using (var writer = stream.CreateExcelWriter()) { for (int i = 0; i < 1000000; i++) { writer.WriteRow(new { Id = i, Value = $"Data_{i}" }); } }

这种方式逐行写入数据，内存占用始终保持在较低水平，特别适合处理大型Excel文件。

4. 模板导出：基于现有模板生成报表

MiniExcel支持使用模板文件生成带格式的Excel报表，只需在模板中标记占位符即可：

var templatePath = "template.xlsx"; var data = new { Title = "销售报表", Date = DateTime.Now, Items = salesData }; MiniExcel.SaveAsByTemplate(templatePath, "report.xlsx", data);

模板文件可包含复杂格式、公式和图表，生成的报表将保留原始格式并填充动态数据。

5. 多工作表操作：同时处理多个Sheet

MiniExcel允许在一个Excel文件中创建多个工作表，满足复杂数据组织需求：

var sheets = new Dictionary<string, object> { { "Sheet1", data1 }, { "Sheet2", data2 } }; sheets.ToExcel("multi_sheet.xlsx");

通过字典指定工作表名称和对应数据，轻松实现多工作表导出。

6. CSV格式支持：跨格式数据转换

除了Excel格式，MiniExcel还支持CSV文件的读写，实现不同格式间的无缝转换：

// Excel转CSV MiniExcel.Query("data.xlsx").ToCsv("data.csv"); // CSV转Excel MiniExcel.Query("data.csv").ToExcel("data.xlsx");

这一功能在数据交换和导入导出场景中非常实用。

7. 数据筛选与转换：灵活处理数据

导入数据时，可通过LINQ查询对数据进行筛选和转换：

var filteredData = MiniExcel.Query<Person>("input.xlsx") .Where(p => p.Age > 18) .Select(p => new { p.Name, p.Age }) .ToList();

结合LINQ的强大功能，可轻松实现复杂的数据处理逻辑。

8. 自定义列名与格式：个性化Excel输出

通过特性配置，可以自定义导出的列名和数据格式：

public class Product { [ExcelColumnName("产品名称")] public string Name { get; set; } [ExcelColumnFormat("0.00")] public decimal Price { get; set; } }

使用这些特性后，导出的Excel将使用指定的列名和数值格式，提升报表的可读性。

9. 异步操作：提升应用响应性能

MiniExcel提供了完整的异步API，适合在Web应用等场景中使用，避免阻塞主线程：

// 异步导出 await data.ToExcelAsync("output.xlsx"); // 异步导入 var rows = await MiniExcel.QueryAsync<Person>("input.xlsx").ToListAsync();

异步操作有助于提高应用的并发处理能力和响应速度。

10. 跨平台支持：Windows、Linux与Mac通用

MiniExcel基于.NET Standard开发，可在多种操作系统上运行。以下是在Linux系统中使用的示例：

# 在Linux中通过.NET CLI创建项目并安装MiniExcel dotnet new console -n ExcelDemo cd ExcelDemo dotnet add package MiniExcel

编写代码后，直接运行即可在Linux环境下处理Excel文件，实现跨平台的Excel操作。

三、实际应用场景展示

上图展示了MiniExcel在不同操作系统和开发环境中的应用效果。无论是Windows下的Visual Studio，还是Linux下的终端命令行，MiniExcel都能提供一致的功能体验，帮助开发者在各种场景下高效处理Excel数据。

四、总结与资源

通过以上10个实用示例，我们可以看到MiniExcel作为一款高效、易用的Excel处理库，在数据导入导出、模板生成、大型文件处理等方面都表现出色。其低内存占用和跨平台特性使其成为.NET开发者处理Excel文件的理想选择。

更多详细文档和示例代码可参考项目中的docs/目录，以及src/MiniExcel/下的源代码实现。如果需要获取最新版本或参与项目贡献，可以通过以下命令克隆仓库：

git clone https://gitcode.com/gh_mirrors/mi/MiniExcel

开始使用MiniExcel，让Excel处理变得简单高效！

【免费下载链接】MiniExcelFast, Low-Memory, Easy Excel .NET helper to import/export/template spreadsheet (support Linux, Mac)项目地址: https://gitcode.com/gh_mirrors/mi/MiniExcel