前言
在桌面开发应用中，处理 Excel 文件是一个非常常见的需求。无论是生成报表、导入数据，还是与客户或其他系统进行数据交换，Excel 文件都扮演着重要角色。在 .NET 生态系统中，有许多处理 Excel 文件的工具和库，其中最轻量级和高效的选择之一就是 MiniExcel。本文将探讨为什么在 .NET 中使用 MiniExcel 是处理 Excel 文件的最佳方式，并展示其基本用法。
为什么选择 MiniExcel？
-
轻量级与高性能：MiniExcel 是一个专注于高性能的轻量级库，它不依赖于 Excel Interop 或其他庞大的依赖项。对于那些不需要处理复杂 Excel 特性的应用，MiniExcel 能够以极高的速度读取和写入数据。其核心设计思想是简单、快速。
-
内存占用低：相比于其他 Excel 处理库（如 EPPlus、NPOI），MiniExcel 的内存占用非常低，适合在内存敏感的环境中使用，特别是当你需要处理大数据量的 Excel 文件时。
-
简单易用：MiniExcel 提供了简洁的 API 接口，开发者可以轻松地使用它来读写 Excel 文件。它的设计原则是“开箱即用”，大多数情况下不需要复杂的配置或设置。
-
跨平台支持：MiniExcel 完全基于 .NET Standard，因此可以在 Windows、Linux 和 macOS 等多种平台上运行，适合现代跨平台应用的需求。
如何在 .NET 项目中使用 MiniExcel
1. 安装 MiniExcel
首先，你需要在你的 .NET 项目中安装 MiniExcel。你可以通过 NuGet 包管理器来完成这一操作：
dotnet add package MiniExcel
或使用 Visual Studio 的 NuGet 包管理器 UI 搜索并安装 MiniExcel 包。
2. 读取 Excel 文件
读取 Excel 文件在 MiniExcel 中非常简单。假设我们有一个简单的 Excel 文件 data.xlsx，其结构如下：
| Name | Age | Country |
|---|---|---|
| John | 30 | USA |
| Alice | 25 | Canada |
| Bob | 22 | UK |
我们可以使用以下代码读取它：
using MiniExcel;
using System.Collections.Generic;var filePath = "data.xlsx";// 读取 Excel 文件并将其转换为动态对象的集合
var rows = MiniExcel.Query(filePath);// 遍历并输出数据
foreach (var row in rows)
{Console.WriteLine($"{row.Name} - {row.Age} - {row.Country}");
}
在这个例子中，MiniExcel.Query 方法将 Excel 文件读取为一个动态对象的集合，使得数据访问更加直观。
3. 写入 Excel 文件
写入 Excel 文件同样简单。假设我们有以下数据需要写入一个新的 Excel 文件：
var data = new List<dynamic>
{new { Name = "张三", Age = 30, Country = "张村" },new { Name = "李四", Age = 25, Country = "李村" },new { Name = "王五", Age = 22, Country = "王村" }
};MiniExcel.SaveAs("output.xlsx", data);
运行这段代码后，你会发现生成的 output.xlsx 文件中包含了我们定义的数据。
4. 处理大数据量
如果你需要处理非常大的数据集，MiniExcel 的优势会更加明显。以下示例展示了如何生成一个包含百万行数据的 Excel 文件：
var data = new List<dynamic>();for (int i = 0; i < 1000000; i++)
{data.Add(new { Name = $"User {i}", Age = 20 + (i % 30), Country = "Country" + (i % 100) });
}MiniExcel.SaveAs("large_output.xlsx", data);
MiniExcel 的高效性能确保即使在处理如此大规模的数据时，内存占用也保持在合理范围内，且操作速度依然非常快。
总结
MiniExcel 是 .NET 生态中处理 Excel 文件的一个极佳选择，尤其适用于那些需要高效处理 Excel 文件而又不需要复杂 Excel 功能的场景。它以其轻量级、高性能、易用性和跨平台支持等优势，成为了许多开发者的首选。如果你正在寻找一个简单且强大的 Excel 处理库，不妨试试 MiniExcel。
参考文档：
https://github.com/mini-software/MiniExcel/blob/master/README.zh-CN.md
https://gitee.com/dotnetchina/MiniExcel/blob/master/README.zh-CN.md
)
