在生成或处理 Excel 文件时，经常会遇到单元格内容显示不完整的问题。例如，文本太长导致列宽不够、换行内容显示不全，或者批量写入数据后表格布局不够整齐。
如果只是手动处理一个文件，可以在 Excel 中双击行列边界进行自动调整。但在后台程序、批量报表生成、数据导出等场景中，更常见的做法是通过代码自动调整行高和列宽。
本文将介绍如何使用 C# 自动调整 Excel 中的行高和列宽，主要包括以下几种场景：
- 自动调整整个工作表的行高和列宽
- 自动调整指定列的列宽
- 自动调整指定行的行高
- 自动调整指定单元格区域的行高和列宽
准备工作
本文示例使用 Free Spire.XLS for .NET 操作 Excel 文件。可以通过 NuGet 安装：
Install-Package FreeSpire.XLS代码中需要引入以下命名空间：
arduino
using Spire.Xls;示例中使用的 Excel 文件路径为：
makefile
E:\Files\Test.xlsx实际使用时，可以根据自己的文件路径进行修改。
一、自动调整整个工作表的行高和列宽
如果需要让工作表中的数据尽量完整显示，可以获取工作表的已使用区域，然后调用 AutoFitColumns() 和 AutoFitRows() 方法。
csharp
using Spire.Xls;
namespace AutofitColumn
{
class Program
{
static void Main(string[] args)
{
// 创建 Workbook 对象
Workbook workbook = new Workbook();
// 加载 Excel 文件
workbook.LoadFromFile(@"E:\Files\Test.xlsx");
// 获取第一个工作表
Worksheet worksheet = workbook.Worksheets[0];
// 自动调整已使用区域的列宽
worksheet.AllocatedRange.AutoFitColumns();
// 自动调整已使用区域的行高
worksheet.AllocatedRange.AutoFitRows();
// 保存结果文件
workbook.SaveToFile(@"E:\Files\AutoFit.xlsx", FileFormat.Version2010);
workbook.Dispose();
}
}
}这里的 AllocatedRange 表示当前工作表中实际使用到的单元格区域。相比直接处理整个工作表，它更适合用于普通数据表，也可以避免对大量空白区域进行不必要的处理。
二、自动调整指定列的列宽
有些表格并不需要调整所有列，只需要处理某些内容较长的字段，例如"产品名称""客户名称""地址""备注"等。这种情况下，可以只对指定列执行自动调整。
下面的示例用于自动调整第一列的列宽：
csharp
using Spire.Xls;
namespace AutoFitSpecificColumn
{
class Program
{
static void Main(string[] args)
{
Workbook workbook = new Workbook();
workbook.LoadFromFile(@"E:\Files\Test.xlsx");
Worksheet worksheet = workbook.Worksheets[0];
// 自动调整第 1 列的列宽
// 注意：这里的列索引从 1 开始
worksheet.AutoFitColumn(1);
workbook.SaveToFile(@"E:\Files\AutoFitColumn.xlsx", FileFormat.Version2010);
workbook.Dispose();
}
}
}如果需要调整多列，可以使用循环：
css
// 自动调整第 1 列到第 3 列
for (int i = 1; i <= 3; i++)
{
worksheet.AutoFitColumn(i);
}这种方式适合列数较多，但只有部分字段需要自适应宽度的表格。
三、自动调整指定行的行高
当单元格中包含换行文本、较大字号文本，或者导入内容较多时，行高可能无法完整显示内容。此时可以只调整指定行的高度。
下面的示例用于自动调整第一行的行高：
csharp
using Spire.Xls;
namespace AutoFitSpecificRow
{
class Program
{
static void Main(string[] args)
{
Workbook workbook = new Workbook();
workbook.LoadFromFile(@"E:\Files\Test.xlsx");
Worksheet worksheet = workbook.Worksheets[0];
// 自动调整第 1 行的行高
// 注意：这里的行索引从 1 开始
worksheet.AutoFitRow(1);
workbook.SaveToFile(@"E:\Files\AutoFitRow.xlsx", FileFormat.Version2010);
workbook.Dispose();
}
}
}如果需要调整多行，也可以使用循环：
css
// 自动调整第 1 行到第 10 行
for (int i = 1; i <= 10; i++)
{
worksheet.AutoFitRow(i);
}这种方式比较适合处理标题行、说明行，或者某些内容长度不固定的数据行。
四、自动调整指定单元格区域
在实际业务中，很多 Excel 文件并不是整个工作表都需要处理。例如，一个工作表中可能同时包含标题、说明、数据表、签名区域等内容。此时可以只对某个指定区域自动调整行高和列宽。
下面的示例对 A1:D10 区域进行自动调整：
ini
using Spire.Xls;
namespace AutoFitRange
{
class Program
{
static void Main(string[] args)
{
Workbook workbook = new Workbook();
workbook.LoadFromFile(@"E:\Files\Test.xlsx");
Worksheet worksheet = workbook.Worksheets[0];
// 获取指定单元格区域
CellRange range = worksheet.Range["A1:D10"];
// 自动调整该区域的列宽
range.AutoFitColumns();
// 自动调整该区域的行高
range.AutoFitRows();
workbook.SaveToFile(@"E:\Files\AutoFitRange.xlsx", FileFormat.Version2010);
workbook.Dispose();
}
}
}这种方式适合报表模板类文件。例如只调整数据明细区域，而不影响上方标题、页眉说明或底部备注区域的布局。
注意事项
自动调整行高和列宽主要根据单元格中的内容进行计算。实际使用时，可以注意以下几点：
1. 自动换行： 如果单元格中包含较长文本或多行文本，可以先开启自动换行，再调用 AutoFitRows() 自动调整行高。
ini
// 开启已使用区域的自动换行
worksheet.AllocatedRange.IsWrapText = true;
// 根据内容自动调整行高
worksheet.AllocatedRange.AutoFitRows();需要注意的是，IsWrapText = true 会改变单元格的显示样式，使文本在单元格内自动换行。如果希望保持原有模板布局，不建议对整个工作表直接设置，可以只对指定区域设置：
ini
CellRange range = worksheet.Range["A1:D10"];
range.IsWrapText = true;
range.AutoFitRows();2. 合并单元格： 如果表格中存在合并单元格，自动调整行高或列宽的效果可能与普通单元格不同，尤其是跨多列合并的文本区域。对于这类区域，可以在自动调整后检查显示效果，必要时手动设置行高或列宽。
3. 空白单元格： 如果单元格内容为空，自动调整通常不会产生明显变化。实际处理时，建议优先对已使用区域或指定数据区域执行自动调整。
4. 性能开销： 对于数据量较大的工作簿，建议只调整实际需要处理的局部区域，避免对整个工作表进行不必要的计算。
总结
在 C# 中处理 Excel 文件时，自动调整行高和列宽是一个很常见的需求。对于普通数据表，可以直接对工作表的已使用区域调用 AutoFitColumns() 和 AutoFitRows()；对于结构较复杂的文件，则可以只处理指定行、指定列或指定单元格区域。
合理使用这些方法，可以让程序生成的 Excel 文件更加整洁，也能减少用户后续手动调整表格布局的工作。