C#使用ClosedXML向已有Excel文档写入数据无效问题求解

代码里的明确错误 #

• 第一段代码存在基础语法错误：获取工作表的写法workbook(1)不成立，ClosedXML中需要通过Worksheet()方法取工作表，这段代码本身无法正常编译运行。
• 两段代码的单元格坐标传参顺序搞反了：Cell()方法的参数顺序是**(行号, 列号)**，第二段代码你算出最后一列的列号后，把列号当成了行号传入，实际写入位置和你预期的位置完全不一致，很容易误以为没有写入成功。
• 保存方法使用不当：打开现有工作簿修改时，直接调用Save()即可将修改写回原文件，用SaveAs()传入原文件路径很容易触发文件占用冲突，导致写入失败。

常见静默失败的原因 #

• 目标Excel文件正被WPS、Microsoft Excel等程序打开，文件被系统加锁，此时写入操作不会成功，部分场景下不会抛出明确异常。
• 误用StreamWriter写xlsx文件：xlsx是压缩格式的结构化文档，不是纯文本文件，用StreamWriter写入会直接损坏文件结构，不可能实现正常更新。

可直接运行的修正代码 #

public void WriteToReport(List<BrandData> brandData, string reportFilePath)
{
    // 先校验文件是否被占用，避免无提示失败
    using (var checkStream = new FileStream(reportFilePath, FileMode.Open, FileAccess.ReadWrite, FileShare.None))
    {
        checkStream.Close();
    }

    using (var workbook = new XLWorkbook(reportFilePath))
    {
        // 取文件内第一个工作表
        var worksheet = workbook.Worksheet(1);
        
        // 固定位置写入示例：B26单元格（第26行第2列）
        worksheet.Cell(26, 2).Value = "Hello World!";

        // 追加列写入示例：在已使用区域的下一列第一行写入内容
        int lastUsedColumn = worksheet.LastColumnUsed().ColumnNumber();
        worksheet.Cell(1, lastUsedColumn + 1).Value = "Hello World";

        // 保存修改到原文件
        workbook.Save();
    }
}

备选类库推荐 #

如果ClosedXML不符合使用习惯，可以选择以下经过大量生产场景验证的Excel操作类库：

• NPOI：开源免费，对老版本xls和新版xlsx格式兼容性好，不需要依赖本地Office组件
• EPPlus：新版对非商用场景免费，API设计简洁，大文件处理性能较好

内容的提问来源于stack exchange，提问作者Ford Burgess