使用Python的fpdf2库multi_cell生成表格异常的解决方案及替代库咨询

一、修复当前FPDF代码的问题 #

你当前代码的核心问题是multi_cell的光标位置管理混乱，且固定行高无法适配多行文本的单元格。要实现自适应行高的表格，需先计算每行所有单元格的最大高度，再统一绘制该行的所有单元格：

def createTable(self, tableData):
    self.set_font('DejaVu', 'B', 10)
    colWidth = self.epw / len(tableData[0])
    line_height = self.font_size * 1.2  # 基础行高，可根据字体调整

    for rowId, row in enumerate(tableData):
        # 第一步：计算当前行所有单元格的高度，取最大值
        max_height = 0
        cell_heights = []
        for dataCell in row:
            text = str(dataCell)
            # 仅计算文本换行后的行数，不实际绘制
            num_lines = self.multi_cell(colWidth, line_height, text, border=0, align='C', fill=False, split_only=True)
            cell_height = num_lines * line_height
            cell_heights.append(cell_height)
            if cell_height > max_height:
                max_height = cell_height

        # 第二步：设置行背景色
        if rowId % 2 == 0:
            self.set_fill_color(255, 255, 255)
        else:
            self.set_fill_color(220, 220, 220)

        # 第三步：绘制当前行的所有单元格
        current_x = self.get_x()
        current_y = self.get_y()
        for colId, dataCell in enumerate(row):
            self.multi_cell(
                colWidth,
                max_height,
                str(dataCell),
                border=1,
                align='C',
                fill=True
            )
            # 重置光标位置到下一列起始点
            self.set_y(current_y)
            self.set_x(current_x + colWidth * (colId + 1))
        
        # 跳转到下一行起始位置
        self.set_y(current_y + max_height)
        self.set_x(0)

关键改进点：

• 用split_only=True参数提前计算文本换行行数，避免无效绘制
• 取当前行单元格的最大高度作为统一行高，彻底解决错位问题
• 统一管理光标坐标，确保每行绘制逻辑清晰

二、推荐支持自适应表格的PDF库 #

如果不想在旧版FPDF上折腾，以下几个库更适合处理带自动换行和自适应单元格的表格：

1. ReportLab #

Python主流PDF生成库，内置Table组件原生支持文本换行与单元格高度自适应：

from reportlab.lib.pagesizes import letter
from reportlab.platypus import SimpleDocTemplate, Table, TableStyle
from reportlab.lib import colors

doc = SimpleDocTemplate("table.pdf", pagesize=letter)
table_data = [["短文本", "很长很长的文本需要自动换行显示在单元格内"], ["另一行短文本", "中等长度的文本内容"]]
table = Table(table_data)
# 自定义表格样式
style = TableStyle([
    ('BACKGROUND', (0,0), (-1,0), colors.grey),
    ('TEXTCOLOR', (0,0), (-1,0), colors.whitesmoke),
    ('ALIGN', (0,0), (-1,-1), 'CENTER'),
    ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
    ('FONTSIZE', (0,0), (-1,0), 12),
    ('BOTTOMPADDING', (0,0), (-1,0), 12),
    ('BACKGROUND', (0,1), (-1,-1), colors.beige),
    ('GRID', (0,0), (-1,-1), 1, colors.black)
])
table.setStyle(style)
doc.build([table])

2. WeasyPrint #

基于HTML/CSS的PDF生成工具，用网页布局语法实现表格，完全支持自动换行和自适应：

from weasyprint import HTML

html_content = """
<html>
<head>
<style>
table { border-collapse: collapse; width: 100%; }
th, td { border: 1px solid black; padding: 8px; text-align: center; }
tr:nth-child(even) { background-color: #f2f2f2; }
</style>
</head>
<body>
<table>
    <tr><th>标题1</th><th>标题2</th></tr>
    <tr><td>短文本</td><td>很长很长的文本需要自动换行显示在单元格内，测试自适应高度效果</td></tr>
</table>
</body>
</html>
"""
HTML(string=html_content).write_pdf("table_weasyprint.pdf")

3. FPDF2（FPDF官方升级版） #

修复了旧版FPDF的诸多问题，新增原生table方法，自动处理换行与单元格高度：

from fpdf import FPDF

pdf = FPDF()
pdf.add_page()
pdf.set_font("DejaVu", size=10)
table_data = [
    ["列1", "列2"],
    ["短内容", "非常长的文本内容，会自动换行并调整单元格高度，无需手动计算"]
]
# 直接调用table方法生成自适应表格
pdf.table(table_data, col_widths=(pdf.epw/2, pdf.epw/2), align="C")
pdf.output("fpdf2_table.pdf")

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