C#借助GemBox.Spreadsheet实现Excel单元格换行顶部空隙问题如何解决

问题场景 #

• 开发C#控制台应用，需要生成Excel文件，实现单个单元格内的多行文本展示，预期的单元格内容效果如下：

this is line 1 text
this is line 2 text

已尝试的实现方案 #

• 先后测试两种换行写入方式，均触发单元格顶部出现额外空隙的异常：
  1. 使用Environment.NewLine拼接换行的代码片段：

  worksheet.Cells[0, 0].Value = "Components";
  worksheet.Rows[1].Cells[0].Style.WrapText = true;
  
  worksheet.Cells[1, 0].Value = "this is line 1 and "+Environment.NewLine+" this is line 2"; 
  

  2. 使用\n转义字符插入换行的代码片段：

  worksheet.Cells[0, 0].Value = "Components";
  worksheet.Rows[1].Cells[0].Style.WrapText = true;
  
  worksheet.Cells[1, 0].Value = "this is line 1 and \n this is line 2"; 
  

异常表现 #

• 上述两种代码运行后，带换行内容的单元格顶部都会生成不必要的额外空隙
• 即使关闭文本自动换行属性、仅单独使用\n或Environment.NewLine插入换行符，该多余空隙依然存在

可复现异常的完整测试代码 #

当前使用的第三方类库为gembox.spreadsheet，完整测试代码如下：

using GemBox.Spreadsheet; 

// 专业版本需在此处填写授权序列号
SpreadsheetInfo.SetLicense("FREE-LIMITED-KEY");

// 新建空Excel文件并添加工作表
ExcelFile workbook = new ExcelFile();
ExcelWorksheet worksheet = workbook.Worksheets.Add("Issues");

worksheet.Cells[0, 0].Value = "Components";
worksheet.Rows[1].Cells[0].Style.WrapText = true;

worksheet.Cells[1, 0].Value = "this is line 1 and "+Environment.NewLine+" this is line 2";

// 保存生成的Excel文件
workbook.Save("E:/.net projects/CSharpToExcel/JsonToExcel.xlsx");

Console.WriteLine("data inserted successfully");
Console.ReadKey(); 

问题根源与修复方案 #

多余空隙的来源可通过三个维度的配置调整消除：

• 对齐配置：GemBox.Spreadsheet 对启用自动换行的单元格，默认样式的垂直对齐存在边距冗余，手动指定为顶部对齐即可消除上下偏移

• 文本拼接：示例代码中换行符后拼接了前置空格，会在视觉上放大顶部空隙的感知，移除换行符前后的无效空格即可收紧排版

• 行高配置：类库默认的自动行高规则对带换行符的文本计算值偏保守，会拉高行高形成冗余空间，可手动设置适配内容的行高修正偏差

• 调整后的核心实现代码：

worksheet.Cells[0, 0].Value = "Components";
var targetCell = worksheet.Rows[1].Cells[0];
// 启用文本自动换行
targetCell.Style.WrapText = true;
// 设置垂直对齐为顶部，消除默认对齐带来的上下空隙
targetCell.Style.VerticalAlignment = VerticalAlignment.Top;
// 移除换行符前后的多余空格，保持排版紧凑
targetCell.Value = "this is line 1 and" + Environment.NewLine + "this is line 2";
// 手动设置适配内容的行高，修正自动行高的计算偏差
worksheet.Rows[1].Height = 28;

内容的提问来源于stack exchange，提问作者Dildar Hussain