Linux下用Python将含图表图片的XLSX转PDF的格式问题

问题背景 #

• 待转换XLSX包含大量图表、表格及PNG水印图片
• Linux环境下，使用命令行libreoffice --headless --invisible --convert-to pdf ./Book1.xlsx转换后，PDF文本和格式严重错乱
• 同一文件在Windows Excel导出PDF正常，Linux下LibreOffice Calc GUI打开显示正常
• 需求：优先用Python实现正确格式的XLSX转PDF

已参考资料 #

• 基于Ghostscript和LibreOffice的XLSX命令行打印方案
• Python指定Excel工作表转PDF的实现
• 多种Python XLSX转PDF的方法总结
• Linux下Python直接打印XLSX的相关讨论（未获有效解答）
• 支持带图表XLSX工作簿的Python库调研

可行解决方案 #

1. 优化LibreOffice命令行参数 #

既然GUI能正常渲染，问题出在无头模式的默认配置，尝试以下参数组合：

# 指定Calc模块，避免组件自动选择错误
libreoffice --headless --calc --convert-to pdf --outdir ./output ./Book1.xlsx

# 或添加更多兼容参数，确保格式保留
libreoffice --headless --convert-to pdf --outdir ./output \
--norestore --nofirststartwizard --invisible \
./Book1.xlsx

补充：若存在字体错乱，可安装Windows常用字体（如微软雅黑、宋体）到Linux系统的字体目录（/usr/share/fonts或~/.fonts），更新字体缓存后重试。

2. Python调用LibreOffice API（pyoo库） #

通过Python直接控制LibreOffice Calc的转换流程，比命令行更可控：

步骤1：安装依赖

sudo apt install libreoffice libreoffice-sdk
pip install pyoo

步骤2：启动LibreOffice服务

libreoffice --headless --accept="socket,host=localhost,port=2002;urp;" --nofirststartwizard &

步骤3：转换代码

import pyoo

# 连接LibreOffice服务
desktop = pyoo.Desktop('localhost', 2002)
# 打开目标工作簿
wb = desktop.open_workbook('./Book1.xlsx')
# 导出为PDF，可指定页码范围（示例：全部工作表）
wb.export_to_pdf('./output.pdf', pages=(1, len(wb.sheets)))
# 清理资源
wb.close()
desktop.terminate()

3. Wine+win32com模拟Windows Excel转换（终极格式兼容） #

如果前两种方案仍无法解决格式问题，可通过Wine在Linux下运行Windows Excel，利用win32com调用原生Excel导出：

步骤1：安装Wine并部署Windows Excel

sudo apt install wine
# 下载Windows Excel安装包，通过Wine完成安装

步骤2：Python转换代码

import win32com.client
import os

# 初始化Excel应用
excel = win32com.client.Dispatch("Excel.Application")
excel.Visible = False  # 后台运行

# 打开工作簿
file_path = os.path.abspath('./Book1.xlsx')
wb = excel.Workbooks.Open(file_path)

# 导出为PDF（0对应xlTypePDF）
pdf_path = os.path.abspath('./output.pdf')
wb.ExportAsFixedFormat(0, pdf_path)

# 清理资源
wb.Close(SaveChanges=False)
excel.Quit()

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