使用C#导出List数据与4×4数组至Excel的技术实现问询

阿华AIGC实验室

2026-5-12

解决Excel导出：带表头的单列List + 带行列表头的4×4数组

我来帮你完善这个Excel导出的逻辑，刚好之前做过类似的需求，咱们先梳理下你的核心需求：把20条List数据做成带表头的单列，再把4×4数组做成带行列表头的表格，最后导出到Excel。先看看你现有代码的几个待优化点，再给出完整的解决方案：

现有代码的待优化点

没有给List添加表头，导出后数据没有标识
缺少4×4数组的导出逻辑（包括行列表头的写入）
新建工作簿后又打开了另一个文件，逻辑冲突（建议二选一：要么新建空白工作簿，要么打开已有模板）
未处理Excel资源释放，容易导致后台残留Excel进程

完整解决方案代码

下面是调整后的完整代码，我加了详细注释，你可以直接套用：

using Microsoft.Office.Interop.Excel; // 统一命名空间，避免NsExcel和Excel冲突
using System;
using System.Windows.Forms; // 如果是WinForms项目，用于弹出提示框

public void Data_to_Excel()
{
    Application excapp = null;
    Workbook workbook = null;
    Worksheet sheet = null;

    try
    {
        // 1. 初始化Excel应用
        excapp = new Application();
        excapp.Visible = true; // 调试时可见，发布后可设为false后台导出

        // 二选一：新建空白工作簿 或 打开现有模板
        // 选项1：新建空白工作簿
        workbook = excapp.Workbooks.Add(XlWBATemplate.xlWBATWorksheet);
        sheet = (Worksheet)workbook.Sheets[1]; // 取第一个工作表

        // 选项2：打开现有工作簿（基于模板导出）
        // string workbookPath = @"C:\YourTemplateFile.xlsx";
        // workbook = excapp.Workbooks.Open(workbookPath, 0, false, 5, "", "", false, XlPlatform.xlWindows, "", true, false, 0, true, false, false);
        // sheet = (Worksheet)workbook.Sheets[1];

        // 2. 导出带表头的List数据（A列：A1为表头，A2-A21为20条数据）
        string listHeader = "底部行数统计结果"; // 替换成你的List表头文本
        sheet.Range["A1"].Value2 = listHeader;
        sheet.Range["A1"].Font.Bold = true; // 表头加粗，更醒目

        int listRowCounter = 2; // 从第2行开始写入数据
        foreach (var item in Sim_Obj.Bottom_Rows_Count_Stack)
        {
            sheet.Range[$"A{listRowCounter}"].Value2 = item.ToString();
            listRowCounter++;
        }

        // 3. 导出带行列表头的4×4数组（布局：B列行表头，C-F列数据列，C1-F1列表头）
        // 替换成你实际的行列表头文本
        string[] columnHeaders = { "指标A", "指标B", "指标C", "指标D" };
        string[] rowHeaders = { "场景1", "场景2", "场景3", "场景4" };
        // 替换成你实际的4×4数组数据
        double[,] dataArray = new double[4, 4]
        {
            {10.5, 20.3, 15.7, 8.9},
            {12.1, 25.6, 18.2, 9.4},
            {9.8, 22.4, 16.3, 10.1},
            {11.7, 23.8, 17.5, 9.7}
        };

        // 写入列表头（C1-F1）
        for (int col = 0; col < columnHeaders.Length; col++)
        {
            sheet.Cells[1, col + 3].Value2 = columnHeaders[col];
            sheet.Cells[1, col + 3].Font.Bold = true;
        }

        // 写入行表头（B2-B5）
        for (int row = 0; row < rowHeaders.Length; row++)
        {
            sheet.Cells[row + 2, 2].Value2 = rowHeaders[row];
            sheet.Cells[row + 2, 2].Font.Bold = true;
        }

        // 写入数组核心数据（C2-F5）
        for (int row = 0; row < 4; row++)
        {
            for (int col = 0; col < 4; col++)
            {
                sheet.Cells[row + 2, col + 3].Value2 = dataArray[row, col];
            }
        }

        // 4. 优化格式：自动调整列宽，让内容完整显示
        sheet.UsedRange.Columns.AutoFit();

        // 5. 保存文件（建议用绝对路径，避免找不到文件）
        string savePath = @"C:\YourExportPath\Cash_Surge_Sim_Results.xlsx";
        workbook.SaveAs(savePath);

        MessageBox.Show("Excel导出成功！");
    }
    catch (Exception ex)
    {
        MessageBox.Show($"导出失败：{ex.Message}");
    }
    finally
    {
        // 6. 必须释放Excel资源，避免后台残留进程
        if (workbook != null)
        {
            workbook.Close();
            System.Runtime.InteropServices.Marshal.ReleaseComObject(workbook);
        }
        if (excapp != null)
        {
            excapp.Quit();
            System.Runtime.InteropServices.Marshal.ReleaseComObject(excapp);
        }
        sheet = null;
        workbook = null;
        excapp = null;
        GC.Collect();
        GC.WaitForPendingFinalizers();
    }
}

关键说明

命名空间统一：我统一使用Microsoft.Office.Interop.Excel，解决了你代码里NsExcel和Excel的命名冲突问题
资源释放：finally块里的资源释放逻辑非常关键，能彻底关闭Excel进程，避免后台残留
布局灵活：如果需要调整表格位置（比如把数组放到G列开始），只需要修改代码里的列索引即可
格式优化：表头加粗、自动列宽让导出的Excel更美观，符合日常使用习惯
错误处理：try-catch块能捕获导出过程中的异常，避免程序崩溃