如何使用ReportLab将CSV数据以表格形式写入PDF？

嘿，这个问题我之前做报表的时候也踩过坑！直接把CSV的字符串内容硬写到PDF里，排版肯定会乱得一塌糊涂。不过ReportLab其实自带了专门的表格组件，完全能实现和CSV一致的规整表格效果，下面是具体的实现步骤和代码示例：

核心思路 #

ReportLab的Table和TableStyle组件可以帮我们轻松构建结构化表格，只需先把CSV数据读取成二维列表，再用这两个组件定义样式和布局就行。

完整代码示例 #

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

def csv_to_pdf(csv_file_path, pdf_file_path):
    # 1. 读取CSV数据，转换成二维列表（表头+所有行）
    with open(csv_file_path, 'r', encoding='utf-8') as f:
        csv_reader = csv.reader(f)
        table_data = list(csv_reader)
    
    # 2. 创建PDF文档对象，设置页面尺寸为标准信纸大小
    doc = SimpleDocTemplate(pdf_file_path, pagesize=letter)
    elements = []
    
    # 3. 创建表格对象，传入CSV的二维数据
    table = Table(table_data)
    
    # 4. 定义表格样式（这是让表格整洁的关键！）
    style = TableStyle([
        # 整体外边框：黑色细边框
        ('BOX', (0,0), (-1,-1), 1, colors.black),
        # 内部网格线：灰色细边框
        ('GRID', (0,0), (-1,-1), 0.5, colors.lightgrey),
        # 表头样式：深蓝色背景、白色文字、加粗、居中对齐
        ('BACKGROUND', (0,0), (-1,0), colors.darkblue),
        ('TEXTCOLOR', (0,0), (-1,0), colors.white),
        ('ALIGN', (0,0), (-1,0), 'CENTER'),
        ('FONTNAME', (0,0), (-1,0), 'Helvetica-Bold'),
        ('FONTSIZE', (0,0), (-1,0), 12),
        # 内容行样式：左对齐、常规字体大小
        ('ALIGN', (0,1), (-1,-1), 'LEFT'),
        ('FONTSIZE', (0,1), (-1,-1), 10),
        # 设置行高：表头行更高，内容行适中
        ('ROWHEIGHT', (0,0), (-1,0), 20),
        ('ROWHEIGHT', (0,1), (-1,-1), 15),
    ])
    
    table.setStyle(style)
    
    # 可选：让表格自适应页面宽度（按列数均分页面）
    column_count = len(table_data[0])
    table._argW = [doc.pagesize[0] * (1/column_count) for _ in range(column_count)]
    
    # 5. 将表格添加到PDF元素列表，生成最终文档
    elements.append(table)
    doc.build(elements)

# 调用示例：替换成你的CSV路径和输出PDF路径
csv_to_pdf('your_data.csv', 'output_table.pdf')

关键细节说明 #

• 数据格式转换：用csv.reader把CSV直接转换成二维列表，ReportLab的Table组件可以直接识别这种格式，不需要手动拼接字符串
• 样式定制：TableStyle里的每个元组对应一条样式规则，格式为(样式类型, 起始单元格, 结束单元格, 参数)，你可以根据需求修改颜色、字体、对齐方式甚至单元格背景色
• 列宽调整：如果不想均分页面，可以手动指定列宽，比如把table._argW改成[100, 150, 80]这样的数值列表，每个数值对应一列的宽度
• 长文本处理：如果单元格内容太长，可以在TableStyle里添加('WORDWRAP', (0,0), (-1,-1))来实现自动换行

额外优化建议 #

• 如果CSV包含中文，要确保文件编码是utf-8，还可以指定支持中文的字体（需要把FONTNAME改成对应字体的路径或名称）
• 可以添加页面标题、页码等元素，配合Paragraph组件和样式表实现更完整的文档结构
• 处理超大CSV文件时，可以拆分数据分页生成，避免内存溢出

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