问题点分析：

在日常开发中，将数据导出为 Excel 是高频需求。但当数据包含中文时，列宽自适应常常失效，导致内容显示不全，严重影响用户体验。本文将深入探讨如何使用 C#（借助 EPPlus 库）实现数据导出，并重点解决中文列宽自适应这一棘手问题。

为什么中文列宽自适应会失败？

• 字符宽度差异： Excel 的 AutoFitColumns() 方法主要针对等宽英文字符设计。中文字符宽度通常相当于英文字符的 1.5 - 2 倍，计算时容易被低估。
• 字体影响： 不同字体（如宋体 vs 微软雅黑）下，中文字符的实际渲染宽度有差异。
• 库的局限性： 常用库（如 EPPlus、NPOI）的自动调整算法对双字节字符支持不够完善。

解决方案：手动计算并设置列宽

核心思路是遍历数据，计算每列最大内容宽度，并手动设置列宽。以下是基于 EPPlus 库的详细实现：

using OfficeOpenXml;
using System.Data;

public class ExcelExporter
{
    public static void ExportToExcel(DataTable dataTable, string filePath)
    {
        // 设置 EPPlus 许可证上下文（社区版）
        ExcelPackage.LicenseContext = LicenseContext.NonCommercial;

        using (var package = new ExcelPackage())
        {
            // 创建工作表
            var worksheet = package.Workbook.Worksheets.Add("数据导出");

            // 1. 加载数据 & 设置表头
            worksheet.Cells["A1"].LoadFromDataTable(dataTable, true);

            // 2. 手动计算并设置列宽 (解决中文自适应问题)
            for (int col = 0; col < dataTable.Columns.Count; col++)
            {
                double maxWidth = 8; // 设置最小默认宽度

                // 遍历表头单元格 (第1行)
                string headerText = dataTable.Columns[col].ColumnName;
                double headerWidth = CalculateTextWidth(headerText);
                if (headerWidth > maxWidth) maxWidth = headerWidth;

                // 遍历数据行 (第2行到最后一行)
                for (int row = 0; row < dataTable.Rows.Count; row++)
                {
                    string cellValue = dataTable.Rows[row][col]?.ToString() ?? "";
                    double cellWidth = CalculateTextWidth(cellValue);
                    if (cellWidth > maxWidth) maxWidth = cellWidth;
                }

                // 设置列宽 (增加一点额外空间，避免边缘拥挤)
                // EPPlus 的列宽单位与 Excel 的“字符宽度”近似，但需微调
                worksheet.Column(col + 1).Width = maxWidth + 1.5; 
            }

            // 3. 保存文件
            package.SaveAs(new FileInfo(filePath));
        }
    }

    // 关键函数：计算文本显示所需宽度 (考虑中英文差异)
    private static double CalculateTextWidth(string text)
    {
        if (string.IsNullOrEmpty(text)) return 0;

        double width = 0;
        foreach (char c in text)
        {
            // 核心逻辑：区分中文字符和英文字符
            if (c > 255) // 通常认为 >255 的字符属于中/日/韩等宽字符
            {
                width += 2.2; // 一个中文字符大致相当于 2.2 个英文字符宽度
            }
            else
            {
                width += 1.0; // 英文字符、数字、标点等按1计算
            }
        }
        return width;
    }
}

代码详解与关键点

1. CalculateTextWidth 方法：

   • 这是解决中文问题的核心。
   • 遍历字符串中的每个字符。
   • 判断字符是否为中文（或其他宽字符）：if (c > 255) 是一个常用但非绝对精确的简单判断。更严谨可用 char.GetUnicodeCategory(c)，但此方法在多数场景下足够。
   • 中文字符宽度系数 (2.2)： 这是经验值。一个中文字符在常用字体（如宋体、微软雅黑）下，其显示宽度通常等于 2 个英文字符。2.2 提供了额外缓冲，可根据实际使用的 Excel 字体微调（值越大列越宽）。
   • 英文字符宽度系数 (1.0)： 作为基础单位。

2. 列宽计算循环：

   • 遍历每一列 (col)。
   • 初始化 maxWidth 为合理的最小值 (8)。
   • 计算表头宽度： 确保列标题完整显示。
   • 遍历该列所有数据行： 找出该列中最宽的内容。
   • 使用 CalculateTextWidth 计算每个单元格内容的“理论宽度”。
   • 始终保持 maxWidth 为当前找到的最大值。

3. 设置列宽：

   • worksheet.Column(col + 1).Width = maxWidth + 1.5;
   • col + 1 是因为 EPPlus 列索引从 1 开始。
   • 在计算出的最大宽度 (maxWidth) 基础上增加一个缓冲值 (1.5)。这是为了：
     • 补偿计算中的微小误差。
     • 避免内容紧贴单元格边缘，提升可读性。
     • 容纳可能存在的边框或单元格内边距。

注意事项与优化建议

1. 字体影响： 2.2 和 1.5 是基于常用字体（如宋体、Arial、Calibri）的经验值。如果使用特殊字体，可能需要调整这些系数。测试是关键！
2. 性能考量： 对于超大型数据集（数万行以上），遍历所有单元格计算宽度可能影响性能。优化策略：
   • 抽样计算：随机选取部分行计算最大宽度。
   • 预估：根据字段类型预估宽度（如 ID 列窄，备注列宽）。
   • 设置最大宽度限制：避免单列过宽 (worksheet.Column(col).Width = Math.Min(calculatedWidth, maxAllowedWidth)）。
3. 合并单元格： 如果存在合并单元格，上述简单遍历逻辑可能不适用。需要额外处理合并区域内的文本宽度计算。
4. 格式影响： 单元格内换行符 (\n)、字体加粗、斜体等也会影响实际显示所需宽度。本示例未考虑这些复杂格式。
5. 替代库： 如果使用 NPOI，思路相同：手动计算最大宽度，然后通过 sheet.SetColumnWidth(colIndex, widthInUnits) 设置。NPOI 中宽度单位是 1/256 个字符宽度，计算需转换。

总结

通过摒弃 AutoFitColumns()，采用手动遍历数据计算每列最大文本宽度，并针对中文字符赋予更高的宽度系数，我们有效解决了 C# 导出 Excel 时中文列宽自适应失败的问题。虽然比自动调整稍复杂，但能确保各类数据（尤其是中文内容）清晰、完整地展示。

CalculateTextWidth 中 2.2 的系数和设置列宽时的 +1.5 缓冲是实践中的关键调优点。开发者应根据实际项目使用的字体和数据特点进行微调，并通过充分测试达到最佳显示效果。

技术要点回顾：

• 核心问题：Excel 自动列宽计算对中文等宽字符支持不足。
• 解决方案：手动计算文本宽度，区分中英文字符。
• 关键方法：CalculateTextWidth 实现字符级宽度累加。
• 优化点：缓冲值设置、性能考虑、字体适配。
• 推荐库：EPPlus（免费商用需注意License）或NPOI。