pandas.to_excel无法直接添加复杂样式，需借助openpyxl（导出后追加）或xlsxwriter（边写边设）；openpyxl要求用load_workbook重新打开文件并注意索引从1开始，xlsxwriter需预定义格式且不支持修改已有文件。
不能直接用 pandas 的 to_excel 添加复杂样式——它只支持基础格式（如日期、数字格式），真要加边框、背景色、合并单元格，得靠 openpyxl 或 xlsxwriter 二次操作。
用 openpyxl 在导出后追加样式（推荐）
这是最灵活的方式：先用 pandas.to_excel 写入数据，再用 openpyxl 加载工作簿并操作单元格。注意必须关闭 engine='openpyxl' 的写模式，否则会报 ReadOnlyWorkbook 错误。
实操要点：
- 保存时指定
engine='openpyxl'，且不传workbook参数，让 pandas 创建新文件 - 重新用
openpyxl.load_workbook()打开（此时是可写模式） - 样式对象（如
PatternFill、Font、Border）需显式赋给cell.style或cell.font等属性，不能只创建不绑定 - 行/列索引从 1 开始（不是 0），比如
ws.cell(row=1, column=1)是 A1
示例：给标题行加浅蓝背景和粗体
立即学习“Python免费学习笔记（深入）”；
from openpyxl import load_workbook
from openpyxl.styles import PatternFill, Font, Alignment
<h1>先导出数据</h1><p>df.to_excel('report.xlsx', index=False, engine='openpyxl')</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill4102" title="Shadows Python Sensei"><img
src="https://img.php.cn/upload/skill/000/000/081/178990406882325.jpg" alt="Shadows Python Sensei" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill4102" title="Shadows Python Sensei">Shadows Python Sensei</a>
<p>Python 最佳实践助手——代码规范、设计模式、性能优化、测试与类型注解。适用于编写或审查 Python 代码。</p>
</div>
<a href="/xiazai/skill4102" title="Shadows Python Sensei" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><h1>再加载并加样式</h1><p>wb = load_workbook('report.xlsx')
ws = wb.active</p><h1>设置标题行（第1行）</h1><p>for col in range(1, len(df.columns) + 1):
cell = ws.cell(row=1, column=col)
cell.fill = PatternFill(start_color="DCE6F1", end_color="DCE6F1", fill_type="solid")
cell.font = Font(bold=True)
cell.alignment = Alignment(horizontal="center")</p><p>wb.save('report.xlsx')
用 xlsxwriter 边写边设样式（适合全新导出）
如果你不需要读取已有 Excel、只是生成新表，xlsxwriter 更高效，支持在写入时直接套用格式对象。但它不支持读取/修改已有文件，且不能处理已存在的 .xlsx 中的公式或图表。
关键限制：
- 所有样式必须通过
workbook.add_format()预定义，不能直接改单元格属性 - 不能对已写入的单元格“回填”样式，必须在
write()时传入 format 对象 - 不支持合并单元格后单独设置某子单元格样式（合并后整体控制）
- 中文需显式设置
font_name，否则可能显示为方块，例如add_format({'font_name': 'Microsoft YaHei'})
示例：带边框和居中的表头
import pandas as pd
<p>writer = pd.ExcelWriter('report.xlsx', engine='xlsxwriter')
df.to_excel(writer, sheet_name='Sheet1', index=False)</p><p>workbook = writer.book
worksheet = writer.sheets['Sheet1']</p><h1>定义格式</h1><p>header_format = workbook.add_format({
'bold': True,
'bg_color': '#DCE6F1',
'border': 1,
'align': 'center'
})</p><h1>给第一行应用格式（注意：列数从0开始，但 xlsxwriter 的 set_row 也是从0起）</h1><p>for col_num, value in enumerate(df.columns):
worksheet.write(0, col_num, value, header_format)</p><p>writer.close()
常见样式失败原因和绕过方式
很多“样式没生效”其实不是代码错，而是环境或逻辑卡点：
-
openpyxl中改了cell.fill却没变色？检查是否覆盖写了cell.style = 'Normal'或其他预设 style，这会清空手动设置的 fill/font - 用
df.style.set_properties(**{'background-color': 'yellow'})导出后全是空白？这是Styler对象，只能导出 HTML 或带样式的 Excel（需df.style.to_excel()），且仅支持有限样式，不支持边框/字体大小 - 合并单元格后内容消失？确保先写内容再合并，顺序反了内容会被丢弃；用
ws.merge_cells('A1:C1')后，只保留左上角单元格（A1）的值 - 导出的 Excel 打开提示“发现不可读内容”？多因同时用了
openpyxl和xlsxwriter引擎写同一个文件，或手动修改了.xlsx的 XML 结构
真正麻烦的不是写几行样式代码，而是样式与数据写入时机的耦合——尤其是合并单元格、条件格式、冻结窗格这类操作，一旦顺序或索引错一位，就得重开文件调试。建议小范围先试，别等全量导出完再加样式。
