前言

日常工作中經常與數據打交道的同學肯定會難以避免對Excel的一些數據操作如導入、導出等，但是當對一些大數據量操作Excel時經常會遇到一個常見的問題內存溢出。今天給大家推薦一個簡單、高效、低內存避免OOM（內存溢出）的.NET操作Excel開源框架：MiniExcel。

官方介紹

MiniExcel簡單、高效避免OOM的.NET處理Excel查、寫、填充數據工具。目前主流框架大多需要將數據全載入到內存方便操作，但這會導致內存消耗問題，MiniExcel 嘗試以 Stream 角度寫底層算法邏輯，能讓原本1000多MB占用降低到幾MB，避免內存不夠情況。

項目特點

• 低內存耗用，避免OOM、頻繁 Full GC 情況。

• 支持即時操作每行數據。

• 兼具搭配 LINQ 延遲查詢特性，能辦到低消耗、快速分頁等復雜查詢。

• 輕量，不需要安裝 Microsoft Office、COM ，DLL小于150KB。

• 簡便操作的 API 風格。

主流Excel操作框架性能對比

導入、查詢 Excel 比較

導出、創建 Excel 比較

快速開始

注意：下面只展示部分代碼示例，詳情框架功能請前往源碼地址查看：https://gitee.com/dotnetchina/MiniExcel

Query 查詢 Excel 返回強型別 IEnumerable 數據

public class UserAccount
{
public Guid ID { get; set; }
public string Name { get; set; }
public DateTime BoD { get; set; }
public int Age { get; set; }
public bool VIP { get; set; }
public decimal Points { get; set; }
}

using (var stream = File.OpenRead(path))
var rows = stream.Query<UserAccount>;


Query 查詢 Excel 返回Dynamic IEnumerable 數據


var rows = MiniExcel.Query(path).ToList;

Assert.Equal("MiniExcel", rows[0].A);
Assert.Equal(1, rows[0].B);
Assert.Equal("Github", rows[1].A);
Assert.Equal(2, rows[1].B);
}


支持集合<匿名類別>或是<強型別>

var path = Path.Combine(Path.GetTempPath, $"{Guid.NewGuid}.xlsx");
MiniExcel.SaveAs(path, new[] {
new { Column1 = "MiniExcel", Column2 = 1 },
new { Column1 = "Github", Column2 = 2}
});


IEnumerable<IDictionary<string, object>>

var values = new List<Dictionary<string, object>>
{
new Dictionary<string,object>{{ "Column1", "MiniExcel" }, { "Column2", 1 } },
new Dictionary<string,object>{{ "Column1", "Github" }, { "Column2", 2 } }
};
MiniExcel.SaveAs(path, values);


IDataReader

推薦使用，可以避免載入全部數據到內存.

MiniExcel.SaveAs(path, reader);


推薦 DataReader 多表格導出方式(建議使用 Dapper ExecuteReader )

using (var cnn = Connection)
{
cnn.Open;
var sheets = new Dictionary<string,object>;
sheets.Add("sheet1", cnn.ExecuteReader("select 1 id"));
sheets.Add("sheet2", cnn.ExecuteReader("select 2 id"));
MiniExcel.SaveAs("Demo.xlsx", sheets);
}

項目源碼地址

更多項目實用功能和特性歡迎前往項目開源地址查看?，別忘了給項目一個Star支持?。

https://gitee.com/dotnetchina/MiniExcel

優秀項目和框架精選

該項目已收錄到C#/.NET/.NET Core優秀項目和框架精選中，關注優秀項目和框架精選能讓你及時了解C#、.NET和.NET Core領域的最新動態和最佳實踐，提高開發工作效率和質量。坑已挖，歡迎大家踴躍提交PR推薦或自薦（讓優秀的項目和框架不被埋沒?）。

https://github.com/YSGStudyHards/DotNetGuide/blob/main/docs/DotNet/DotNetProjectPicks.md