当前位置:

首页 > 编程开发 > Python结合Spire.XLS for Python实现将CSV转为PDF

Python结合Spire.XLS for Python实现将CSV转为PDF

CSV文件以纯文本形式存储表格数据,通用性确实很强,但一到了正式场合——比如向客户交付数据报表、归档项目文档或者打印材料——它的短板就暴露无遗了:没有格式、列宽不均、分页混乱,阅读体验大打折扣。 PDF则恰好弥补了这些缺陷。它固定排版,跨平台显示一致,是正式文档的首选格式。这里介绍一种简单直接的方法

本文目录

    CSV文件以纯文本形式存储表格数据,通用性确实很强,但一到了正式场合——比如向客户交付数据报表、归档项目文档或者打印材料——它的短板就暴露无遗了:没有格式、列宽不均、分页混乱,阅读体验大打折扣。

    PDF则恰好弥补了这些缺陷。它固定排版,跨平台显示一致,是正式文档的首选格式。这里介绍一种简单直接的方法:利用 Spire.XLS for Python 库,将CSV文件加载为工作簿,调整表格样式,再导出为规整的PDF文档。整个过程只需十几行代码,无需安装Microsoft Excel。

    Python结合Spire.XLS for Python实现将CSV转为PDF

    准备工作

    在开始编码之前,先安装所需的依赖库:

    pip install Spire.XLS

    Spire.XLS for Python 是一个功能强大的Excel操作库,支持读取、写入、转换等多种操作,且不依赖任何本地Excel组件。

    完整代码实现

    下面是一段完整的转换代码,涵盖加载、样式调整和导出三个核心步骤:

    from spire.xls import *
    from spire.xls.common import *
    # 创建 Workbook 对象
    workbook = Workbook()
    # 加载 CSV 文件(参数:文件路径, 分隔符, 起始行, 起始列)
    workbook.LoadFromFile("sample.csv", ",", 1, 1)
    # 设置页面缩放,确保内容适配一页
    workbook.ConverterSetting.SheetFitToPage = True
    # 获取第一个工作表
    sheet = workbook.Worksheets[0]
    # 自动调整每一列的列宽,避免内容被截断
    i = 1
    while i < sheet.Columns.Length:
        sheet.AutoFitColumn(i)
        i += 1
    # 导出为 PDF
    workbook.SaveToFile("CSVToPDF.pdf", FileFormat.PDF)
    workbook.Dispose()

    关键步骤解析

    加载CSV文件:Workbook 是操作的核心类。LoadFromFile 方法除了传入文件路径外,还支持指定分隔符、起始读取行和起始读取列。例如 ",", 1, 1 表示以逗号为分隔符,从第一行第一列开始读取。如果你的CSV文件使用制表符或分号分隔,只需替换为 "\t" 或 ";" 即可。

    一页完整显示:workbook.ConverterSetting.SheetFitToPage = True 是一个容易被忽略却至关重要的设置。如果不开启此项,当表格列数较多时,导出的PDF可能会将内容拆分到多页,阅读时需要来回翻页,非常不便。开启后,PDF页面会自动缩放,保证所有列在一页内完整呈现。

    自动调整列宽:通过循环调用 sheet.AutoFitColumn(i),让每一列的宽度根据该列最长文本内容自动调整。这样既能避免文字重叠或显示为"####",也能让表格看起来更加整洁专业。

    导出为PDF:最后调用 SaveToFile 并指定 FileFormat.PDF,即可生成PDF文件。Dispose 方法用于释放资源,养成良好习惯。

    进一步美化表格

    上面的示例已经能满足基本需求,但如果你希望PDF的样式更加精致,Spire.XLS 还提供了更多定制选项。例如,设置字体、字号、对齐方式,或调整页面方向:

    # 设置全局字体和字号
    sheet.AllocatedRange.Style.Font.FontName = "Arial"
    sheet.AllocatedRange.Style.Font.Size = 14
    # 设置水平居中对齐
    sheet.AllocatedRange.Style.HorizontalAlignment = HorizontalAlignType.Center
    # 将页面方向调整为横向
    sheet.PageSetup.Orientation = PageOrientationType.Landscape

    这些设置能让导出的PDF更加符合正式文档的要求。

    适用场景

    这一方案尤其适合以下场景:

    • 批量生成报表:定期从数据库导出CSV,自动转换为PDF归档。
    • 数据交付:向客户或合作方提供格式固定的数据文档,避免因软件版本不同导致排版错乱。
    • 无Excel环境的服务器:Spire.XLS 不依赖本地Excel,可在Linux服务器上稳定运行。

    知识扩展

    方法一:使用 Pandas + Matplotlib(将表格转为图片 PDF)

    这种方法将数据框绘制为 Matplotlib 表格,然后保存为 PDF(本质是图片)。优点是代码简单,缺点是生成的 PDF 不可选择文本,且缩放可能模糊。

    import pandas as pd
    import matplotlib.pyplot as plt
    from matplotlib.table import Table
    def csv_to_pdf_matplotlib(csv_path, pdf_path, title='数据报表'):
        """
        将 CSV 文件转为 PDF(表格图片形式)
        """
        df = pd.read_csv(csv_path)
        fig, ax = plt.subplots(figsize=(12, len(df) * 0.4 + 2))
        ax.axis('off')
        ax.set_title(title, fontsize=16, pad=20)
        # 创建表格
        tb = Table(ax, bbox=[0, 0, 1, 1])
        nrows, ncols = df.shape
        col_width = 1.0 / ncols
        row_height = 1.0 / (nrows + 1)
        # 添加表头(背景色浅蓝)
        for j, col_name in enumerate(df.columns):
            tb.add_cell(0, j, col_width, row_height,
                        text=col_name, loc='center',
                        facecolor='#4472C4', text_props=dict(color='white', weight='bold'))
        # 添加数据行
        for i, row in df.iterrows():
            for j, val in enumerate(row):
                tb.add_cell(i + 1, j, col_width, row_height,
                            text=str(val), loc='center')
        ax.add_table(tb)
        plt.savefig(pdf_path, dpi=300, bbox_inches='tight')
        plt.close()
        print(f'✅ PDF 已保存至: {pdf_path}')
    # 使用示例
    csv_to_pdf_matplotlib('trades.csv', 'trades_report.pdf')

    方法二:使用 ReportLab(生成真正的 PDF 表格,可复制文本)

    ReportLab 是 Python 生成 PDF 的专业库,能产生矢量文本,样式可控性强,适合需要高质量打印或正式报告的场景。

    import pandas as pd
    from reportlab.lib.pagesizes import A4, landscape
    from reportlab.platypus import SimpleDocTemplate, Table, TableStyle, Paragraph, Spacer
    from reportlab.lib import colors
    from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle
    from reportlab.lib.enums import TA_CENTER
    from reportlab.pdfbase import pdfmetrics
    from reportlab.pdfbase.ttfonts import TTFont  # 用于中文
    def csv_to_pdf_reportlab(csv_path, pdf_path, title='交易记录报表'):
        """
        使用 ReportLab 将 CSV 转为可复制文本的 PDF
        """
        # 注册中文字体(如果需要)
        try:
            pdfmetrics.registerFont(TTFont('SimHei', 'SimHei.ttf'))  # 请确保字体文件存在
            cn_font = 'SimHei'
        except:
            cn_font = 'Helvetica'  # 回退,中文可能显示为方框
        df = pd.read_csv(csv_path)
        # 创建 PDF 文档(横向 A4)
        doc = SimpleDocTemplate(pdf_path, pagesize=landscape(A4),
                                rightMargin=30, leftMargin=30,
                                topMargin=30, bottomMargin=30)
        # 构建内容列表
        elements = []
        # 标题样式
        styles = getSampleStyleSheet()
        title_style = ParagraphStyle(
            'CustomTitle',
            parent=styles['Heading1'],
            fontName=cn_font,
            fontSize=18,
            alignment=TA_CENTER,
            spaceAfter=20
        )
        elements.append(Paragraph(title, title_style))
        elements.append(Spacer(1, 12))
        # 准备表格数据:将 DataFrame 转为列表,并插入表头
        data = [df.columns.tolist()] + df.values.tolist()
        # 创建表格(样式)
        table = Table(data, repeatRows=1)  # 表头在每页重复
        # 设置表格样式
        style = TableStyle([
            ('BACKGROUND', (0, 0), (-1, 0), colors.HexColor('#4472C4')),
            ('TEXTCOLOR', (0, 0), (-1, 0), colors.whitesmoke),
            ('ALIGN', (0, 0), (-1, -1), 'CENTER'),
            ('FONTNAME', (0, 0), (-1, 0), cn_font),
            ('FONTSIZE', (0, 0), (-1, 0), 10),
            ('FONTNAME', (0, 1), (-1, -1), cn_font),
            ('FONTSIZE', (0, 1), (-1, -1), 8),
            ('BOTTOMPADDING', (0, 0), (-1, 0), 8),
            ('TOPPADDING', (0, 0), (-1, 0), 8),
            ('GRID', (0, 0), (-1, -1), 0.5, colors.grey),
            ('VALIGN', (0, 0), (-1, -1), 'MIDDLE'),
            ('BACKGROUND', (0, 1), (-1, -1), colors.beige),
            ('ROWBACKGROUNDS', (0, 1), (-1, -1), [colors.whitesmoke, colors.lightgrey]),
        ])
        table.setStyle(style)
        # 如果数据量很大,可启用分页
        elements.append(table)
        doc.build(elements)
        print(f'✅ PDF 已保存至: {pdf_path}')
    # 使用示例
    csv_to_pdf_reportlab('trades.csv', 'trades_report.pdf')

    注意:如果需要显示中文,请确保系统中有中文字体文件(如 SimHei.ttf),并放置在可访问路径,或者直接指定系统字体路径(如 /System/Library/Fonts/PingFang.ttc)。

    总结

    利用 Spire.XLS for Python,只需十几行代码即可完成CSV到PDF的转换,同时还能对表格样式进行灵活控制。SheetFitToPage 与 AutoFitColumn 的组合使用,是保证输出页面整洁美观的关键。如果你正被CSV的"素颜"困扰,不妨试试这个方案。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 Python
    相关文章 更多
    python删除一个列表里的重复元素的方法与代码示例
    python删除一个列表里的重复元素的方法与代码示例

    学习如何使用Python高效删除列表中的重复元素。本文提供5种常见方法的代码示例,涵盖保持顺序与不保持顺序的场景,适合初学者和进阶开发者参考。

    Python写接口的步骤及完整代码示例
    Python写接口的步骤及完整代码示例

    详细讲解使用Python编写Web接口的核心步骤与完整代码示例,涵盖环境准备、路由定义、数据校验、服务启动及调试测试方法。

    codex怎么读取word文档及docx文件操作教程
    codex怎么读取word文档及docx文件操作教程

    介绍如何利用编程工具读取和解析Word文档(docx格式),涵盖基础文本提取代码示例、结构化数据处理逻辑,以及处理复杂排版时的技术局限与替代方案。

    怎么在Python中调用C语言代码提升性能
    怎么在Python中调用C语言代码提升性能

    详细讲解在Python中调用C语言代码提升性能的完整实践指南,包含原理分析、编译步骤、ctypes与CFFI具体实现、性能对比及常见陷阱。

    Python与C语言的性能差异及底层原理
    Python与C语言的性能差异及底层原理

    深入解析Python与C语言在执行效率上的数量级差异,从编译机制、变量内存布局、动态类型推断到GIL锁,系统阐明底层核心原理。

    Python和C语言哪个更适合编程入门
    Python和C语言哪个更适合编程入门

    客观对比Python与C语言在心智负担、底层机制与学习反馈上的核心差异,提供清晰有据的选择标准与切实的入门学习路径。

    selenium上传文件教程本地文件路径设置方法
    selenium上传文件教程本地文件路径设置方法

    深入解析Selenium处理文件上传的技术细节,涵盖标准HTML控件的路径直接注入法与非标准控件的系统级模拟方案,提供Windows与Linux环境下的路径设置最佳实践及常见异常排查。

    大数据开发语言选型:Java对比Scala与Python的优缺点及适用场景
    大数据开发语言选型:Java对比Scala与Python的优缺点及适用场景

    针对大数据工程场景,系统对比Java、Scala与Python在执行性能、生态结合、开发效率和维护成本上的核心差异,给出清晰的架构选型依据与落地方案。

    langgraph python guide中文入门教程详解
    langgraph python guide中文入门教程详解

    本篇LangGraph Python中文入门教程详解,系统梳理StateGraph状态机定义、节点编写、边与条件路由、检查点持久化(MemorySaver)等核心机制,提供从环境安装到完整循环智能体构建的代码示例与实操指导。

    Windows 安装 Python:从官方入口到虚拟环境的可复现实践
    Windows 安装 Python:从官方入口到虚拟环境的可复现实践

    面向后端开发者,基于 Python 官方文档说明如何在 Windows 上安装 Python、创建 venv 虚拟环境及使用 pip 管理依赖。包含可复制命令、验证方法及工具选择边界,避免常见配置误区。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。