EPPlus(v6+)是读取.xlsx最稳选择:纯托管、无需Office、线程安全、性能好;注意LicenseContext设置、用.Text而非.Value、判空Dimension、避免文件格式混淆。
用 EPPlus 读取 .xlsx 是目前最稳的选择
直接说结论:别用 Microsoft.Office.Interop.Excel,它依赖 Office 安装、线程不安全、服务器上基本跑不起来;也别碰已停更的 NPOI 旧版(0.9x),对 .xlsx 支持弱且容易抛 Invalid header signature。推荐用现代、纯托管、NuGet 开箱即用的 EPPlus(v6+,注意需 .NET 5+ 或 .NET Framework 4.6.1+)。
安装命令:
dotnet add package EPPlus
(若用 .NET Core/.NET 5+)或通过 NuGet 包管理器安装 EPPlus v6.x。
关键点:
-
EPPlus不需要 Excel 软件,也不调 COM,纯内存解析,适合后台服务 - v6+ 默认启用「商业用途需授权」提示,若仅内网/非分发场景,可加一行代码关闭:
ExcelPackage.LicenseContext = LicenseContext.NonCommercial;
- 读取时默认不加载样式、公式结果(只读值),性能好;如需公式求值,得手动调用
worksheet.Calculate()
读取第一个 Sheet 的数据:跳过空行、处理标题行
常见需求是把 Excel 表格当二维数据源用,比如首行为列名,后面为记录。用 EPPlus 可这样写:
using (var package = new ExcelPackage(new FileInfo("data.xlsx")))
{
var worksheet = package.Workbook.Worksheets[0]; // 第一个 sheet
var rowCount = worksheet.Dimension?.Rows ?? 0;
var colCount = worksheet.Dimension?.Columns ?? 0;
var data = new List<Dictionary>();
if (rowCount zuojiankuohaophpcn 2) return data;
// 假设第1行是 header
var headers = Enumerable.Range(1, colCount)
.Select(c =youjiankuohaophpcn worksheet.Cells[1, c].Text.Trim())
.ToArray();
for (int row = 2; row zuojiankuohaophpcn= rowCount; row++)
{
var values = new Dictionary();
bool allEmpty = true;
for (int col = 1; col zuojiankuohaophpcn= colCount; col++)
{
var cell = worksheet.Cells[row, col];
var val = cell.Text; // 用 .Text 更安全(避免 null 引用),.Value 是 object 类型需判空转型
values[headers[col - 1]] = val;
if (!string.IsNullOrWhiteSpace(val)) allEmpty = false;
}
if (!allEmpty) data.Add(values);
}
}