Python 实用技巧：使用 Spire.XLS 将 Excel 文件转换为 PDF

场景二：将 Excel 中每个工作表转换为单独的 PDF 文件

当工作表较多或需要独立分发时，可以将每个工作表保存为独立的 PDF 文件。

from spire.xls import *
import os

# 创建 Workbook 对象
workbook = Workbook()

try:
    # 加载 Excel 文件
    workbook.LoadFromFile("data.xlsx")
    
    # 遍历 Excel 工作簿中的所有工作表
    for sheet in workbook.Worksheets:
        # 获取工作表名称，用于生成文件名
        sheet_name = sheet.Name
        
        # 清理文件名中的非法字符（可选）
        safe_name = "".join([c if c.isalnum() else '_' for c in sheet_name])
        FileName = f"{safe_name}.pdf"
        
        # 将每个工作表都保存为一个单独的 PDF 文件
        sheet.SaveToPdf(FileName)
        print(f"已生成：{FileName}")
    
    print("所有工作表转换完成。")

except Exception as e:
    print(f"转换过程中出错：{e}")

finally:
    # 释放资源
    workbook.Dispose()

场景三：自定义指定工作表的 PDF 页面设置

对于报表类数据，可能需要精确控制页边距、纸张尺寸和方向。通过 PageSetup 对象可以实现这些配置。

from spire.xls import *

# 创建 Workbook 对象
workbook = Workbook()

try:
    # 加载 Excel 文件
    workbook.LoadFromFile("report_data.xlsx")
    
    # 获取指定的工作表（索引从 0 开始，此处获取第二个工作表）
    sheet = workbook.Worksheets[1]
    
    # 获取 PageSetup 对象以进行页面设置
    pageSetup = sheet.PageSetup
    
    # 设置页边距（单位：英寸）
    pageSetup.TopMargin = 0.5
    pageSetup.BottomMargin = 0.5
    pageSetup.LeftMargin = 0.5
    pageSetup.RightMargin = 0.5
    
    # 设置页面尺寸 (PaperSizeType 枚举)
    # 例如：A4, A3, Letter 等
    pageSetup.PaperSize = PaperSizeType.PaperA4
    
    # 设置页面方向
    pageSetup.Orientation = OrientationType.Portrait  # Portrait: 纵向, Landscape: 横向
    
    # 设置转换时工作表适应页面
    workbook.ConverterSetting.SheetFitToPage = True
    
    # 将该工作表保存为 PDF 文件
    sheet.SaveToPdf("custom_report.pdf")
    
    print("自定义页面设置转换完成。")

except Exception as e:
    print(f"转换失败：{e}")

finally:
    # 释放资源
    workbook.Dispose()

常见问题与注意事项

1. 资源释放

在处理大型 Excel 文件时，内存占用可能较高。务必在代码块末尾调用 workbook.Dispose() 或 sheet.Dispose() 来显式释放非托管资源，防止内存泄漏。

2. 路径编码问题

如果文件路径包含中文或非 ASCII 字符，在某些操作系统下可能会出现读取错误。建议尽量使用英文路径，或在加载前对路径进行编码处理。

3. 替代方案对比

虽然可以使用 openpyxl 读取 Excel 数据，但将其渲染为 PDF 通常需要结合 reportlab 或 wkhtmltopdf，过程较为复杂且难以完美还原原始样式。Spire.XLS 的优势在于能够直接保留 Excel 的公式、图表、条件格式等视觉元素，适合对排版要求较高的场景。

4. 许可证限制

请注意，未授权的试用版本生成的 PDF 文件通常会在底部添加水印。若用于商业项目，请务必购买正式许可证。

总结

通过 Spire.XLS for Python，开发者可以高效地在 Python 环境中实现 Excel 到 PDF 的自动化转换。无论是简单的格式转换，还是复杂的页面定制，该库都能提供稳定的支持。掌握上述三种场景的代码模式，即可应对绝大多数办公文档处理需求。