Reportlab生成PDF时行文本重叠问题求助（9列CSV场景）

核心问题分析 #

行文本重叠通常是因为未给长文本设置自动换行，或者行高固定且小于文本实际占用高度，尤其是多列布局下，长文本（含链接）会超出单元格/行范围导致重叠。

具体修复方案 #

1. 用Paragraph组件替代直接绘制文本 #

Reportlab的drawString不支持自动换行，必须用Paragraph配合样式处理长文本与链接：

from reportlab.lib.styles import ParagraphStyle
from reportlab.lib.enums import TA_LEFT
from reportlab.platypus import Paragraph

# 基础文本样式：设置自动换行、行高
text_style = ParagraphStyle(
    name='Normal',
    fontName='Helvetica',
    fontSize=10,
    leading=12,  # 行高需大于字号，避免换行后重叠
    alignment=TA_LEFT,
    wordWrap='CJK'  # 支持中英文自动换行
)

# 链接样式：继承基础样式，添加颜色和下划线
link_style = ParagraphStyle(
    name='Link',
    parent=text_style,
    textColor='blue',
    underline=True
)

2. 多列数据推荐用Table组件管理 #

9列CSV用Table能更好控制列宽、行高，自动处理单元格内文本换行：

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

# 假设csv_data是读取到的二维列表（含表头）
# 将所有单元格内容转换为Paragraph对象
processed_data = []
for row in csv_data:
    processed_row = []
    for cell in row:
        cell_str = str(cell)
        # 识别链接并渲染
        if 'http' in cell_str:
            p = Paragraph(f'<a href="{cell_str}">{cell_str}</a>', link_style)
        else:
            p = Paragraph(cell_str, text_style)
        processed_row.append(p)
    processed_data.append(processed_row)

# 定义列宽（可根据内容调整比例或固定值）
col_widths = [60]*9  # 9列各分配60宽度，总宽度540适配A4

# 创建表格并设置样式
table = Table(processed_data, colWidths=col_widths)
table_style = TableStyle([
    ('BACKGROUND', (0,0), (-1,0), colors.grey),
    ('TEXTCOLOR', (0,0), (-1,0), colors.whitesmoke),
    ('ALIGN', (0,0), (-1,-1), 'LEFT'),
    ('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),
    ('VALIGN', (0,0), (-1,-1), 'TOP'),  # 单元格内容顶部对齐，避免换行重叠
])
table.setStyle(table_style)

# 生成PDF
doc = SimpleDocTemplate('output.pdf')
doc.build([table])

3. 手动绘制时的换行处理（不用Table的场景） #

如果坚持用Canvas手动绘制，需计算文本宽度并拆分换行，同时调整行坐标：

from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas
from reportlab.lib.utils import simpleSplit

c = canvas.Canvas('output.pdf', pagesize=letter)
page_width, page_height = letter

x_start = 50
y_start = page_height - 50
col_width = 60
line_height = 12

for row_idx, row in enumerate(csv_data):
    # 为每行预留足够垂直空间
    current_y = y_start - row_idx * line_height * 2
    for col_idx, cell in enumerate(row):
        current_x = x_start + col_idx * col_width
        # 将文本拆分为适配列宽的多行
        lines = simpleSplit(str(cell), 'Helvetica', 10, col_width)
        for line_idx, line in enumerate(lines):
            c.drawString(current_x, current_y - line_idx * line_height, line)
c.save()

关键注意点 #

• 行高（leading）必须大于字号，确保换行后上下行不重叠；
• 使用Table时设置VALIGN='TOP'，让单元格内容从顶部开始排列；
• 链接需用Paragraph的<a>标签渲染，配合专属样式；
• 列宽要根据内容调整，避免文本过度挤压导致换行异常。

内容的提问来源于stack exchange，提问作者Mst. Murshida Khnom