Debian LibOffice文件格式转换指南

Debian 下使用 LibreOffice 进行文件格式转换

一 安装与准备

• 在 Debian 上安装 LibreOffice 与常用转换工具：
  • 安装 LibreOffice：sudo apt-get update && sudo apt-get install -y libreoffice
  • 安装命令行转换工具：sudo apt-get install -y unoconv
  • 如需将 PDF 再转为图片，安装 ImageMagick：sudo apt-get install -y imagemagick
• 确认命令可用：soffice -h、unoconv --version、convert -h
• 若 soffice 不在 PATH，可用 which soffice 查找路径，或用软链放入 PATH（如 sudo ln -s /opt/libreoffice*/program/soffice /usr/local/bin/soffice）。

二 命令行快速用法

• 常用命令模板：soffice --headless --convert-to 目标格式[:过滤器] [文件/通配符] [--outdir 输出目录]
• 示例
  • 单个文件转 PDF：soffice --headless --convert-to pdf your.docx
  • 指定输出目录：soffice --headless --convert-to pdf:writer_pdf_Export your.docx --outdir ./pdfs
  • 批量转换：soffice --headless --convert-to pdf *.docx
  • 指定导出过滤器（不同模块使用不同过滤器）：
    • 文字转 PDF：--convert-to pdf:writer_pdf_Export
    • 表格转 CSV：--convert-to csv:"Text - txt - csv (StarCalc)" data.xlsx
    • 演示转 JPG（每页一张）：soffice --headless --convert-to jpg presentation.pptx
  • 使用 unoconv：unoconv -f pdf 123.ppt、unoconv --show（查看支持格式）。

三 进阶场景

• 服务化转换（适合 Web/后台批量）
  • 启动 LibreOffice 监听：soffice --headless --accept="socket,host=127.0.0.1,port=8100;urp;" --nofirststartwizard &
  • 使用 JODConverter 连接端口 8100 执行转换（Java 示例或命令行封装均可）。
• 字体与渲染问题
  • 若报缺共享库（如无头环境）：sudo apt-get install -y libgl1-mesa-glx libsm6
  • 中文字体显示异常时，可将字体复制到 LibreOffice 字体目录并重启服务（如：/usr/share/fonts/truetype/openoffice），再重试转换。

四 常见问题与排查

• 找不到 soffice：用 which soffice 定位路径，必要时建立软链到 /usr/local/bin/soffice。
• 转换静默失败或无输出：添加 --headless --norestore --nofirststartwizard 并查看当前目录是否生成目标文件；必要时前台运行以观察报错。
• 批量通配符无效：确认 shell 已展开（如 *.docx 在包含匹配文件的目录中执行）。
• PDF 转图片：先用 LibreOffice 将文档转为 PDF，再用 ImageMagick：convert input.pdf output.jpg（会按页生成多张图片）。