从系统导出的报表里，总有一两列内容特别长：订单备注、错误日志、商品描述。默认情况下这些文字会横着铺开，要么把相邻列盖住，要么被迫把列宽拉到夸张的程度；只调整行高又不会换行，多出来的部分直接消失。几行数据可以手动拖一拖，几百个文件的批量处理就只能交给脚本。
Excel 对长文本提供了几种互补的处理手段：自动换行让文字在单元格内折行，缩小字体填充让文字压缩到单元格宽度以内，缩进让短文本错开位置，自适应则按内容重新计算列宽与行高。本文用 Spire.XLS for Python 逐一演示这些设置，并给出它们组合使用的写法。
为什么用脚本处理单元格排版
- 批量统一：同一套换行与列宽规则可以套用到所有工作表，避免逐列拖动。
- 结果可预期：列宽、行高、缩进都由参数决定，不依赖手工拖拽留下的隐式状态。
- 可组合：先换行再自适应，或者先缩进再调整列宽，顺序写在代码里即可复现。
环境准备
安装 Spire.XLS：
pip install Spire.XLS
在脚本中导入需要的模块：
from spire.xls import *
from spire.xls.common import *
自动换行
控制换行的属性是单元格样式的 WrapText。开启后，文字在到达列宽边界时自动折到下一行，行高不足时 Excel 会按内容调整：
from spire.xls import *
from spire.xls.common import *
workbook = Workbook()
sheet = workbook.Worksheets[0]
sheet.Range["C1"].Text = "Long descriptions wrap inside the cell when the column is narrow enough"
sheet.Range["C1"].Style.WrapText = True
sheet.Range["C2"].Text = "https://example.com/a/very/long/url/that/should/not/wrap"
sheet.Range["C2"].Style.WrapText = False
workbook.SaveToFile("WrapText.xlsx", ExcelVersion.Version2013)
workbook.Dispose()
Range.Style.WrapText 作用于整个区域，因此可以一次对整列设置，而不必逐格处理。对于 URL、编号这类不允许断行的内容，保持 False 更合适——它们折行后反而更难阅读。
用换行符控制断点
自动换行由列宽决定断点位置，而有些内容希望在指定位置断开，例如地址的每一行、或是列表式的备注。这时可以在文本中写入换行符 \n，并同样开启换行：
from spire.xls import *
from spire.xls.common import *
workbook = Workbook()
sheet = workbook.Worksheets[0]
cell = sheet.Range["C5"]
# 先定好列宽，再写入带显式换行的文本
sheet.SetColumnWidth(cell.Column, 70)
cell.Value = "Line one: order details\nLine two: shipping address\nLine three: remarks"
cell.IsWrapText = True
workbook.SaveToFile("ExplicitLineBreaks.xlsx", ExcelVersion.Version2013)
workbook.Dispose()
这里用的是 cell.IsWrapText，与前面的 Style.WrapText 效果相同，只是作用对象是单个单元格。SetColumnWidth() 的第一个参数是列号（从 1 开始），第二个参数是宽度值；先设列宽再写入文本，可以让断点与列宽匹配。
缩小字体填充
当内容必须完整显示在固定宽度的单元格里，又不能让列变宽时，可以让字体自动缩小。ShrinkToFit 开在样式上：
from spire.xls import *
from spire.xls.common import *
workbook = Workbook()
workbook.LoadFromFile("Template_Xls_1.xlsx")
sheet = workbook.Worksheets[0]
# 让单元格内容在固定宽度内自动缩小以完整显示
cell = sheet.Range["B13:C13"]
style = cell.Style
style.ShrinkToFit = True
workbook.SaveToFile("ShrinkToFit.xlsx", ExcelVersion.Version2013)
workbook.Dispose()
ShrinkToFit 与 WrapText 是两种不同思路：前者保持一行、缩小字号；后者保持字号、增加行数。表格排版固定、不希望行高变化时（例如打印用的模板），选择缩小字体更稳妥。
设置单元格内缩进
缩进常用于让短文本在单元格内错开，形成视觉上的层次，比如分类名称与其子项：
from spire.xls import *
from spire.xls.common import *
workbook = Workbook()
sheet = workbook.Worksheets[0]
cell = sheet.Range["B5"]
cell.Text = "Sub-item"
# 单元格内文本缩进两级
cell.Style.IndentLevel = 2
workbook.SaveToFile("Indentation.xlsx", ExcelVersion.Version2010)
workbook.Dispose()
IndentLevel 的取值是缩进的级数，0 表示不缩进。它只影响文本在单元格内的水平位置，不改变对齐方式，因此可以与左对齐、居中同时使用。
按内容自适应列宽与行高
处理完换行之后，列宽往往还需要按最长的内容重新计算。区域对象提供了 AutoFitColumns() 与 AutoFitRows()：
from spire.xls import *
from spire.xls.common import *
workbook = Workbook()
workbook.LoadFromFile("ReadImages.xlsx")
sheet = workbook.Worksheets[0]
cell = sheet.Range["B8"]
cell.Text = "Welcome to Spire.XLS!"
cell.Style.Font.Size = 10
cell.Style.Font.IsBold = True
# 按单元格内容自适应列宽与行高
cell.AutoFitColumns()
cell.AutoFitRows()
workbook.SaveToFile("AutoFitBasedOnCellValue.xlsx", ExcelVersion.Version2013)
workbook.Dispose()
在区域上调用时，自适应以该区域内最长、最高的内容为准，因此对 sheet.AllocatedRange 调用就等于把整张表的列宽行高重算一遍。
工作表层还提供了按列号自适应的写法，适合只知道列号的场景：
# 对第 2 列自适应，第三个参数为额外宽度
sheet.AutoFitColumn(2, 2, 5)
前两个参数是起止列号，第三个参数在计算结果之上再加一点宽度，留出余量。
组合使用：先换行，再自适应
实际脚本里这几步通常连在一起：写入长文本、开启换行、再让行列按内容收敛。
from spire.xls import *
from spire.xls.common import *
workbook = Workbook()
sheet = workbook.Worksheets[0]
notes = [
"Order confirmed. Payment received on 2026-10-20.",
"Address verified. Shipping scheduled for the next business day.",
"Customer requested gift wrapping.",
]
# 写入长文本并开启换行
for i, note in enumerate(notes, start=1):
cell = sheet.Range[i + 1, 2]
cell.Value = note
cell.IsWrapText = True
# 写入后再按内容自适应
sheet.Range[2, 2, 4, 2].AutoFitRows()
sheet.AutoFitColumn(2, 2, 3)
workbook.SaveToFile("WrapAndAutoFit.xlsx", ExcelVersion.Version2013)
workbook.Dispose()
顺序很重要：如果先自适应再开启换行，行高是按单行文本算出来的，换行后的内容会被压住。先换行、后自适应，行高才会把折行后的行数算进去。
实用建议
- 换行与缩进可以叠加：缩进决定文本起点，换行决定折行位置，两者不冲突。
- 固定模板用缩小字体：打印模板的列宽通常不允许变动，此时
ShrinkToFit比换行更安全。 - URL 与编号不要换行：这类内容折行后难以辨认，保持
WrapText = False即可。 - 自适应放在最后：写入内容、调整样式之后再调用
AutoFitColumns()/AutoFitRows()，否则结果会基于旧内容。 - 只对实际数据区域自适应：对整张表反复自适应会拉长处理时间，批量场景建议限定范围。
- 释放资源：处理完一个工作簿后调用
workbook.Dispose()。
结语
本文介绍了用 Python 处理 Excel 单元格长文本的几种方式：通过 Style.WrapText 与 IsWrapText 开启自动换行，借助 \n 与合适列宽控制换行位置，用 ShrinkToFit 在固定宽度内缩小字体，通过 IndentLevel 设置单元格内缩进，并用 AutoFitColumns()、AutoFitRows() 和 AutoFitColumn() 按内容重算尺寸。把这些设置按"先内容、后样式、再自适应"的顺序组合起来，就能让导出的报表在无人干预的情况下保持整齐。
