NPOI实战避坑：.xls和.xlsx文件处理到底该用HSSF还是XSSF？一个接口全搞定

NPOI实战避坑：.xls和.xlsx文件处理到底该用HSSF还是XSSF？一个接口全搞定

在C#开发中处理Excel文件时，NPOI无疑是.NET开发者最常用的利器之一。但很多刚接触NPOI的开发者经常会遇到一个令人头疼的问题：当需要同时处理.xls和.xlsx两种格式的Excel文件时，到底该使用HSSFWorkbook还是XSSFWorkbook？更糟糕的是，如果在生产环境中错误地使用了不匹配的类，轻则抛出异常，重则导致内存溢出。本文将深入剖析这一常见痛点，并提供一个基于IWorkbook接口的统一解决方案，让你从此告别选择困难症。

1. 理解HSSF与XSSF的本质区别

在开始编码之前，我们需要先搞清楚HSSF和XSSF这两个组件的本质差异。这不是简单的"新旧版本"区别，而是代表了两种完全不同的Excel文件格式架构。

**HSSF（Horrible SpreadSheet Format）**是NPOI中处理Excel 97-2003格式（.xls）的模块。它的特点是：

• 基于二进制文件格式
• 单个工作表最多支持65,536行×256列
• 内存占用相对较小
• 不支持Excel 2007+的新特性（如丰富的样式、条件格式等）

**XSSF（XML SpreadSheet Format）**则是处理Excel 2007+格式（.xlsx）的模块：

• 基于Open XML标准（实质上是ZIP压缩的XML文件集合）
• 单个工作表支持1,048,576行×16,384列
• 支持丰富的现代Excel特性
• 内存占用较大，特别是处理大数据量时

性能对比表：

2. 统一处理方案：IWorkbook接口的妙用

很多开发者不知道的是，HSSFWorkbook和XSSFWorkbook都实现了IWorkbook接口。这意味着我们可以通过接口编程的方式，实现一套代码同时处理两种格式。下面是一个完整的实现示例：

public MemoryStream GenerateExcel(DataTable data, string fileExtension)
{
    IWorkbook workbook;
    
    // 根据扩展名创建对应的工作簿实例
    if (fileExtension.Equals(".xlsx", StringComparison.OrdinalIgnoreCase))
    {
        workbook = new XSSFWorkbook();
    }
    else if (fileExtension.Equals(".xls", StringComparison.OrdinalIgnoreCase))
    {
        workbook = new HSSFWorkbook();
    }
    else
    {
        throw new NotSupportedException("不支持的Excel文件格式");
    }

    // 创建工作表
    ISheet sheet = workbook.CreateSheet("Sheet1");
    
    // 创建表头行
    IRow headerRow = sheet.CreateRow(0);
    for (int i = 0; i < data.Columns.Count; i++)
    {
        headerRow.CreateCell(i).SetCellValue(data.Columns[i].ColumnName);
    }
    
    // 填充数据
    for (int rowIndex = 0; rowIndex < data.Rows.Count; rowIndex++)
    {
        IRow row = sheet.CreateRow(rowIndex + 1);
        for (int colIndex = 0; colIndex < data.Columns.Count; colIndex++)
        {
            row.CreateCell(colIndex).SetCellValue(data.Rows[rowIndex][colIndex].ToString());
        }
    }
    
    // 自动调整列宽
    for (int i = 0; i < data.Columns.Count; i++)
    {
        sheet.AutoSizeColumn(i);
    }
    
    // 写入内存流
    MemoryStream stream = new MemoryStream();
    workbook.Write(stream);
    stream.Position = 0;
    return stream;
}

提示：在实际应用中，建议将fileExtension参数改为从上传的文件名中自动提取，而不是手动指定。可以使用Path.GetExtension(fileName)来获取文件扩展名。

3. 文件上传处理的自动判断机制

在Web应用中处理文件上传时，我们需要能够自动识别上传的Excel文件类型。以下是增强版的自动判断逻辑：

public IWorkbook LoadExcelFile(Stream fileStream, string fileName)
{
    if (fileStream == null || fileStream.Length == 0)