Pandas DataFrame转PDF表格跨页标题覆盖、单元格拆分问题咨询

现有HTML转PDF流程修复 #

你遇到的两个分页异常都是因为缺少适配PDF分页的CSS规则，pdfkit底层调用wkhtmltopdf渲染，添加对应打印样式即可解决：

1. 新增CSS规则解决两个异常：

• thead {display: table-header-group;} 实现每页自动重复表头，配合@page设置页面边距避免表头覆盖内容
• tr, td {page-break-inside: avoid;} 禁止行/单元格内部分页，避免单个单元格被拆分到两页

修改后的完整代码如下：

import pandas as pd
import pdfkit

test1 =  {'Cl1': [1]*57, 
        'Cl2':[1]*57, 
        'Cl3': [1]*57, 
        'Cl4': [1]*57}
test1 = pd.DataFrame(test1)
test1.index += 1

def bk_color_cell(cell):
   # 注意原代码判断条件为cell>0，可根据需求调整为cell>1
   return 'background-color: ' + ('red' if cell > 1 else 'green')

# 自定义适配PDF分页的CSS
custom_style = """
<style>
@page {
    size: A4;
    margin: 2cm; /* 页面预留足够边距，避免内容贴边/覆盖 */
}
table {
    border-collapse: collapse;
    width: 100%;
}
thead {
    display: table-header-group; /* 每页重复渲染表头 */
}
tr, td {
    page-break-inside: avoid; /* 禁止行、单元格拆分到两页 */
    padding: 6px 12px;
    border: 1px solid #eee;
}
</style>
"""

# 拼接自定义样式和渲染后的表格HTML
html = custom_style + test1.style.applymap(bk_color_cell).render()

# 写入文件并转PDF
with open('exp.html','w') as f:
    f.write(html)

pdfkit.from_file('exp.html', 'out1.pdf')

异常效果参考：

替代实现方案 #

如果HTML转PDF方案仍有兼容性问题，可以选择以下更稳定的实现路径：

• ReportLab直接生成PDF：ReportLab是Python生态最成熟的PDF生成工具，表格分页逻辑原生可控，设置repeatRows=1即可自动重复表头，TableStyle可以灵活配置单元格条件背景色，不会出现分页异常。
• Word中转生成PDF：先将带样式的DataFrame写入Word表格（python-docx支持设置单元格背景色），Word的表格分页逻辑默认支持表头重复、避免行拆分，再通过docx2pdf等工具转PDF，配置成本极低。

内容的提问来源于stack exchange，提问作者Ravi Mevada