快速上手EPPlus：5个简单步骤掌握Excel自动化

2026-02-06 05:09:54作者：翟萌耘Ralph

EPPlus是一个功能强大的开源.NET库，专门用于处理Excel文件。它提供了简单易用的API，让.NET开发者能够轻松创建、读取、编辑和导出Excel电子表格，支持公式计算、图表生成、数据验证等高级功能。相比于传统的Office Interop，EPPlus无需安装Microsoft Office，性能更高且部署更简单。

✨ 如何开始使用EPPlus？

1. 安装EPPlus包

首先通过NuGet包管理器安装EPPlus：

dotnet add package EPPlus

或者在Visual Studio的包管理器控制台中运行：

Install-Package EPPlus

2. 📋 如何配置许可证？

EPPlus 8采用双许可证模式，使用前必须配置许可证：

通过代码配置：

// 商业用途（需要购买许可证）
ExcelPackage.License.SetCommercial("您的许可证密钥");

// 非商业个人用途
ExcelPackage.License.SetNonCommercialPersonal("您的姓名");

// 非商业组织用途  
ExcelPackage.License.SetNonCommercialOrganization("组织名称");

通过配置文件配置（appsettings.json）：

{
  "EPPlus": {
    "ExcelPackage": {
      "License": "NonCommercialPersonal:开发者名称"
    }
  }
}

3. 🚀 如何创建第一个Excel文件？

创建一个简单的Excel工作簿只需要几行代码：

using OfficeOpenXml;
using System.IO;

class ExcelCreator
{
    static void Main()
    {
        // 设置许可证
        ExcelPackage.License.SetNonCommercialPersonal("示例用户");
        
        var file = new FileInfo("示例工作簿.xlsx");
        
        using (var package = new ExcelPackage(file))
        {
            // 添加工作表
            var worksheet = package.Workbook.Worksheets.Add("数据表");
            
            // 写入数据
            worksheet.Cells["A1"].Value = "产品名称";
            worksheet.Cells["B1"].Value = "价格";
            worksheet.Cells["A2"].Value = "笔记本电脑";
            worksheet.Cells["B2"].Value = 5999;
            
            // 保存文件
            package.Save();
        }
    }
}

4. 📊 常用功能示例

数据填充和格式化：

// 设置单元格样式
worksheet.Cells["A1:B1"].Style.Font.Bold = true;
worksheet.Cells["A1:B1"].Style.Fill.PatternType = ExcelFillStyle.Solid;
worksheet.Cells["A1:B1"].Style.Fill.BackgroundColor.SetColor(Color.LightGray);

// 自动调整列宽
worksheet.Cells[worksheet.Dimension.Address].AutoFitColumns();

读取现有Excel文件：

using (var package = new ExcelPackage(new FileInfo("现有文件.xlsx")))
{
    var worksheet = package.Workbook.Worksheets[0];
    string value = worksheet.Cells["A1"].Text;
    Console.WriteLine($"A1单元格的值: {value}");
}

5. 🎯 最佳实践和性能优化

批量数据处理：

// 使用LoadFromCollection提高性能
var dataList = new List<Product>();
// ...填充数据...

worksheet.Cells["A2"].LoadFromCollection(dataList, true);

内存管理：

// 及时释放资源
using (var package = new ExcelPackage())
{
    // 处理逻辑
    package.SaveAs(new FileInfo("输出文件.xlsx"));
}

错误处理：

try
{
    using (var package = new ExcelPackage(file))
    {
        // Excel操作代码
    }
}
catch (Exception ex)
{
    Console.WriteLine($"处理Excel文件时出错: {ex.Message}");
}