我之前在使用ClosedXml创建Excel表格时，也碰到过一模一样的坑——想给表头设置带空格的名称，结果改完之后表头变成透明的了。其实问题出在表格内部列名的规则和修改顺序上，给你两个亲测有效的解决办法：

方法一：先设置表头文本，再创建表格 #

这是最稳妥的流程，先把带空格的表头文本写到单元格里，再基于这个范围创建表格，同时给表格列分配合法的内部名称（无空格）：

public static void CreateTable(IXLWorksheet ws, int beginRow, int beginColumn, List<SitesTableModel> sitesList)
{
    // 第一步：先填充带空格的表头文本
    ws.Cell(beginRow, beginColumn).Value = "站点名称";
    ws.Cell(beginRow, beginColumn + 1).Value = "IP 地址";
    ws.Cell(beginRow, beginColumn + 2).Value = "所在区域";
    // 按照你的模型字段，填充所有表头列...

    // 第二步：计算表格的完整范围（表头+数据行）
    int endRow = beginRow + sitesList.Count;
    int endColumn = beginColumn + 2; // 根据实际列数调整
    var tableRange = ws.Range(beginRow, beginColumn, endRow, endColumn);

    // 第三步：创建表格，指定内部表名（合法无空格）
    var table = ws.Tables.Add(tableRange, "SitesDataTable");

    // 给表格列设置合法的内部名称（不能有空格），同时保留单元格的显示文本
    for (int i = 0; i < table.Columns.Count; i++)
    {
        table.Columns[i].Name = $"Col{i+1}"; // 内部列名必须符合Excel命名规则
        table.Columns[i].ShowHeader = true;
    }

    // 第四步：填充数据行（你的原有逻辑）
    int currentRow = beginRow + 1;
    foreach (var site in sitesList)
    {
        ws.Cell(currentRow, beginColumn).Value = site.SiteName;
        ws.Cell(currentRow, beginColumn + 1).Value = site.IpAddress;
        ws.Cell(currentRow, beginColumn + 2).Value = site.Region;
        currentRow++;
    }

    // 强制设置表头样式，确保颜色正常
    ws.Range(beginRow, beginColumn, beginRow, endColumn).Style.Font.SetFontColor(XLColor.Black);
}

方法二：先创建表格，再修改表头单元格（不碰表格列名） #

如果你的代码逻辑已经固定要先创建表格，那可以直接操作表头单元格的文本和样式，不要修改表格列的Name属性（因为那是内部列名，不能有空格）：

public static void CreateTable(IXLWorksheet ws, int beginRow, int beginColumn, List<SitesTableModel> sitesList)
{
    // 先创建表格（ClosedXml会自动生成合法的内部列名，比如Column1、Column2）
    int endRow = beginRow + sitesList.Count;
    int endColumn = beginColumn + 2;
    var tableRange = ws.Range(beginRow, beginColumn, endRow, endColumn);
    var table = ws.Tables.Add(tableRange, "SitesDataTable");

    // 直接修改表头单元格的文本（带空格）
    ws.Cell(beginRow, beginColumn).Value = "站点名称";
    ws.Cell(beginRow, beginColumn + 1).Value = "IP 地址";
    ws.Cell(beginRow, beginColumn + 2).Value = "所在区域";

    // 覆盖表格默认的表头样式，解决透明问题
    var headerRow = table.Range.Row(beginRow);
    headerRow.Style.Font.SetFontColor(XLColor.Black);
    headerRow.Style.Font.SetBold(true); // 可选，让表头更醒目
    headerRow.Style.Fill.SetBackgroundColor(XLColor.LightBlue); // 可选，设置背景色

    // 填充数据行
    int currentRow = beginRow + 1;
    foreach (var site in sitesList)
    {
        ws.Cell(currentRow, beginColumn).Value = site.SiteName;
        ws.Cell(currentRow, beginColumn + 1).Value = site.IpAddress;
        ws.Cell(currentRow, beginColumn + 2).Value = site.Region;
        currentRow++;
    }
}

为什么之前的方法会导致表头透明？ #

因为Excel的表格列名（内部名称）不允许包含空格、特殊字符，当你先创建表格再修改表头单元格文本时，表格的内部列名和单元格显示文本不一致，Excel会认为这是“无效”的表头，自动应用了淡色的异常样式，看起来就像透明了。只要我们区分表格内部列名（必须合法）和表头单元格显示文本（可以自由设置），就可以解决这个问题。

内容的提问来源于stack exchange，提问作者Soufien Hajji