VS2022实战：5分钟搞定NPOI安装与Excel读写（附完整代码）

VS2022极速指南：NPOI控制台应用Excel高效读写实战

在数据处理自动化需求爆炸式增长的今天，Excel文件操作已成为C#开发者必备的核心技能之一。传统依赖Office组件的解决方案不仅部署复杂，在服务器环境更可能引发许可问题。本文将带你使用NPOI这一轻量级神器，在Visual Studio 2022控制台应用中实现Excel文件的高效读写，整个过程无需安装Office套件，特别适合需要批量处理Excel数据的后台服务开发。

1. 环境准备与NPOI安装

1.1 创建控制台项目

打开VS2022，选择"新建项目"，在搜索框中输入console，选择"C#控制台应用(.NET Core)"模板。建议使用.NET 6+版本以获得最佳性能体验，项目命名如ExcelAutomationDemo。

提示：与窗体应用不同，控制台项目更适合作为后台服务或批处理任务运行，减少不必要的UI开销

1.2 通过NuGet安装NPOI

在解决方案资源管理器中右键项目，选择"管理NuGet程序包"。在浏览标签页搜索NPOI，你将看到以下核心组件：

点击安装后，检查项目依赖项是否包含以下关键命名空间：

using NPOI.SS.UserModel; using NPOI.XSSF.UserModel; // for xlsx using NPOI.HSSF.UserModel; // for xls

2. Excel基础读写实现

2.1 创建新Excel文件

以下代码演示如何生成包含简单数据表的xlsx文件：

// 创建2007+格式的工作簿 IWorkbook workbook = new XSSFWorkbook(); ISheet sheet = workbook.CreateSheet("销售数据"); // 添加标题行 IRow headerRow = sheet.CreateRow(0); headerRow.CreateCell(0).SetCellValue("产品ID"); headerRow.CreateCell(1).SetCellValue("产品名称"); headerRow.CreateCell(2).SetCellValue("销售额"); // 添加数据行 var products = new[] { new { ID = 1001, Name = "无线鼠标", Sales = 2580 }, new { ID = 1002, Name = "机械键盘", Sales = 3890 } }; for (int i = 0; i < products.Length; i++) { IRow row = sheet.CreateRow(i + 1); row.CreateCell(0).SetCellValue(products[i].ID); row.CreateCell(1).SetCellValue(products[i].Name); row.CreateCell(2).SetCellValue(products[i].Sales); } // 自动调整列宽 for (int i = 0; i < 3; i++) { sheet.AutoSizeColumn(i); } // 保存文件 using (var fs = new FileStream("SalesReport.xlsx", FileMode.Create)) { workbook.Write(fs); } Console.WriteLine("Excel文件生成完成！");

2.2 读取现有Excel文件

实现一个通用的Excel读取方法，支持同时处理xls和xlsx格式：

public static void ReadExcel(string filePath) { IWorkbook workbook; using (var stream = new FileStream(filePath, FileMode.Open, FileAccess.Read)) { workbook = Path.GetExtension(filePath).ToLower() == ".xlsx" ? new XSSFWorkbook(stream) : new HSSFWorkbook(stream); } ISheet sheet = workbook.GetSheetAt(0); for (int i = 0; i <= sheet.LastRowNum; i++) { IRow row = sheet.GetRow(i); if (row == null) continue; StringBuilder sb = new StringBuilder(); for (int j = 0; j < row.LastCellNum; j++) { ICell cell = row.GetCell(j); sb.Append(GetCellValue(cell) + "\t"); } Console.WriteLine(sb.ToString()); } } private static string GetCellValue(ICell cell) { if (cell == null) return ""; switch (cell.CellType) { case CellType.Numeric: return DateUtil.IsCellDateFormatted(cell) ? cell.DateCellValue.ToString("yyyy-MM-dd") : cell.NumericCellValue.ToString(); case CellType.String: return cell.StringCellValue; case CellType.Boolean: return cell.BooleanCellValue.ToString(); case CellType.Formula: return cell.NumericCellValue.ToString(); default: return ""; } }

3. 高级功能实现

3.1 样式定制技巧

NPOI支持丰富的单元格样式设置，以下示例展示如何创建带格式的报表：

// 创建样式 ICellStyle headerStyle = workbook.CreateCellStyle(); IFont font = workbook.CreateFont(); font.FontName = "微软雅黑"; font.FontHeightInPoints = 12; font.IsBold = true; headerStyle.SetFont(font); headerStyle.FillForegroundColor = IndexedColors.Grey25Percent.Index; headerStyle.FillPattern = FillPattern.SolidForeground; // 应用样式 IRow header = sheet.CreateRow(0); ICell cell = header.CreateCell(0); cell.SetCellValue("带样式的标题"); cell.CellStyle = headerStyle; // 设置数字格式 ICellStyle currencyStyle = workbook.CreateCellStyle(); currencyStyle.DataFormat = workbook.CreateDataFormat().GetFormat("¥#,##0.00"); ICell priceCell = row.CreateCell(2); priceCell.SetCellValue(1999.99); priceCell.CellStyle = currencyStyle;

3.2 大数据量处理优化

当处理超过10万行的数据时，需要特殊优化策略：

• 分块处理：每次处理5000行数据
• 内存管理：及时释放不再使用的对象
• 使用SXSSFWorkbook：针对xlsx的流式处理版本

// 流式工作簿示例 using (SXSSFWorkbook workbook = new SXSSFWorkbook(100)) { // 保留100行在内存 ISheet sheet = workbook.CreateSheet(); for (int i = 0; i < 100000; i++) { IRow row = sheet.CreateRow(i); row.CreateCell(0).SetCellValue($"产品{i}"); // 每处理1000行刷新一次 if (i % 1000 == 0) { ((SXSSFSheet)sheet).FlushRows(100); } } // 保存处理... }

4. 实战问题解决方案

4.1 常见异常处理

在NPOI使用过程中可能遇到的典型问题及解决方案：

4.2 性能对比测试

我们对不同操作方式进行了基准测试（处理10000行数据）：

注意：实际性能会受硬件配置和数据复杂度影响，建议在目标环境进行基准测试

4.3 跨平台部署要点

当需要在Linux服务器运行时，需特别注意：

1. 安装依赖库：

sudo apt-get install libgdiplus

2. 在项目文件中添加运行时标识：

<RuntimeIdentifiers>linux-x64</RuntimeIdentifiers>

3. 避免使用Windows特定功能（如系统字体）

通过本文的实战演示，你会发现NPOI在控制台应用中表现尤为出色，特别是在自动化数据处理场景下。相比原文的窗体应用方案，这种实现方式更加轻量高效，适合集成到各种后台服务中。