在.NET开发中使用 Excel 的最佳方式之一：MiniExcel

前言

在桌面开发应用中，处理 Excel 文件是一个非常常见的需求。无论是生成报表、导入数据，还是与客户或其他系统进行数据交换，Excel 文件都扮演着重要角色。在 .NET 生态系统中，有许多处理 Excel 文件的工具和库，其中最轻量级和高效的选择之一就是 MiniExcel。本文将探讨为什么在 .NET 中使用 MiniExcel 是处理 Excel 文件的最佳方式，并展示其基本用法。

为什么选择 MiniExcel？

1. 轻量级与高性能：MiniExcel 是一个专注于高性能的轻量级库，它不依赖于 Excel Interop 或其他庞大的依赖项。对于那些不需要处理复杂 Excel 特性的应用，MiniExcel 能够以极高的速度读取和写入数据。其核心设计思想是简单、快速。

2. 内存占用低：相比于其他 Excel 处理库（如 EPPlus、NPOI），MiniExcel 的内存占用非常低，适合在内存敏感的环境中使用，特别是当你需要处理大数据量的 Excel 文件时。

3. 简单易用：MiniExcel 提供了简洁的 API 接口，开发者可以轻松地使用它来读写 Excel 文件。它的设计原则是“开箱即用”，大多数情况下不需要复杂的配置或设置。

4. 跨平台支持：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