openpyxl修改单元格样式需显式赋值font/fill/border属性,不可链式调用或区域批量设置;边框须用side+border组合,填充色用patternfill指定6位十六进制色,合并单元格后仅起始单元格保留样式且须在合并后设置。

用 openpyxl 修改单元格字体、边框和填充色
openpyxl 是目前 Python 中最稳定支持 Excel 样式操作的库,openpyxl 的样式对象(如 Font、PatternFill、Border)必须显式赋值给单元格的 font / fill / border 属性,不能链式调用或批量“应用到区域”后自动生效——每个单元格都得单独设。
常见错误是写成:ws['A1:B10'].font = Font(name='微软雅黑'),这会报 AttributeError: 'tuple' object has no attribute 'font',因为切片返回的是元组嵌套元组,不是可直接赋样式的对象。
实操建议:
调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强,支持文件上传与图片 URL 输入。
- 用
ws.iter_rows(min_row=1, max_row=10, min_col=1, max_col=2)遍历单元格,再对每个cell单独设置cell.font、cell.border等 - 边框推荐复用预定义对象,比如
thin_border = Border(left=Side(style='thin'), right=Side(style='thin'), top=Side(style='thin'), bottom=Side(style='thin')),避免每次重复构造 - 填充色用
PatternFill(start_color="FFD9EAD", end_color="FFD9EAD", fill_type="solid"),注意start_color和end_color必须一致,且为 6 位十六进制(不带#),否则颜色不显示
合并单元格后样式丢失或错位
合并单元格(ws.merge_cells('A1:C1'))后,只有左上角单元格(如 A1)保留样式,其余被合并的单元格(B1、C1)样式清空且不可访问——这不是 bug,是 Excel 文件格式限制。
如果你先设了 A1 的字体,再合并 A1:C1,那最终只看得到 A1 的样式;但若你先合并、再设 A1 样式,也仅影响该合并区域的显示效果。关键点在于:合并后不能再对 B1 或 C1 单独赋值或设样式,会静默失败。
实操建议:
- 样式设置务必在
merge_cells()之后进行,且只操作合并区域的起始单元格(如ws['A1']) - 如果需要居中对齐,必须显式设置
Alignment(horizontal='center', vertical='center')并赋给A1,合并本身不带对齐效果 - 避免对已合并区域重复调用
merge_cells(),可能引发ValueError: Cell is merged
条件格式 vs 单元格样式:别混用 openpyxl 的两类机制
openpyxl 里“条件格式”(ConditionalFormatting)和“静态单元格样式”(Font/Fill)是两套完全独立的系统。前者由 Excel 客户端实时计算渲染,后者写死在单元格里。想用 Python 实现“数值大于 100 就标红”,不能靠循环判断后手动设 cell.font.color——那样是静态打标签,无法随数据变化自动更新。
实操建议:
- 要动态响应数据变化,用
ws.conditional_formatting.add('B2:B100', ColorScaleRule(...))或CellIsRule(...),规则写入后 Excel 打开即生效 - 静态美化(如标题行加粗+蓝底)用直接赋样式;动态高亮(如负数变红)优先走条件格式,避免脚本每次重跑
- 条件格式不支持所有样式,例如
PatternFill类型的背景色可用,但渐变填充、图标集需查openpyxl.formatting.rule支持列表,IconSetRule要求至少 3 个阈值
保存后样式在 Excel 中不显示?检查文件打开方式和兼容模式
用 wb.save('report.xlsx') 保存后,双击用 WPS 打开可能看不到边框或部分填充色——WPS 对 openpyxl 写入的某些 Border style(如 'medium'、'dashDot')兼容性差,而 Excel 桌面版基本没问题。
另一个高频问题是:代码里设置了样式,但保存后再用 Excel 打开,发现字体变成 Calibri、颜色变淡。这是因为 openpyxl 默认不写入“主题字体”(Theme-based font),而是用“直接字体”(Direct font),而某些 Excel 版本/视图模式下会降级渲染。
实操建议:
- 强制指定字体 name 为
'SimSun'(宋体)或'Microsoft YaHei'(微软雅黑),避免依赖主题;字号统一用size=10或11,太小的字体(如 8)在部分 Excel 渲染下易模糊 - 保存前确认没启用
keep_vba=True(除非真需要宏),它会导致样式写入异常 - 调试时用
print(cell.font.name, cell.fill.start_color.index)验证样式是否真的写进去了,而不是只看 Excel 显示
样式批量修改真正难的不是写几行代码,而是搞清哪些效果必须靠条件格式、哪些必须靠静态赋值、哪些在不同 Excel 客户端里压根不认——动手前先用 Excel 录制一个宏,看看它生成的 XML 是怎么描述那个边框的,比查文档快得多。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!










