debian liboffice如何转pdf

在 Debian 系统下，将文件（如 Word、Excel、PPT 等）转换为 PDF，通常使用 LibreOffice 的命令行工具 是最简单、稳定的方式。

一、确认已安装 LibreOffice

libreoffice --version

如果未安装，可执行：

sudo apt update
sudo apt install libreoffice

（若只需转换功能，可安装轻量版：libreoffice-core libreoffice-writer 等）

二、使用 LibreOffice 命令行转 PDF（推荐）

1️⃣ 基本转换命令

libreoffice --headless --convert-to pdf 文件名.docx

示例：

libreoffice --headless --convert-to pdf test.docx

✅ 转换后会在当前目录生成 test.pdf

2️⃣ 指定输出目录

libreoffice --headless --convert-to pdf --outdir /home/user/pdf test.docx

3️⃣ 批量转换

libreoffice --headless --convert-to pdf *.docx

或：

for f in *.docx; do
  libreoffice --headless --convert-to pdf "$f"
done

三、常见问题

❌ 报错：无法启动（无显示环境）

确保使用：

--headless

或：

--convert-to pdf:writer_pdf_Export

❌ 转换卡住 / 无反应

通常是用户配置冲突，可指定配置目录：

SAL_USE_VCLPLUGIN=svp libreoffice --headless --convert-to pdf test.docx

或：

HOME=/tmp libreoffice --headless --convert-to pdf test.docx

四、其他方式（补充）

✅ 使用 unoconv（旧方案）

sudo apt install unoconv
unoconv -f pdf test.docx

⚠️ 在新版 LibreOffice 中可能不稳定，不推荐服务器长期使用。

✅ 纯文本 / Markdown

• .txt → PDF：用 libreoffice 或 pandoc
• pandoc 示例：

pandoc input.md -o output.pdf

五、服务器 / Docker 建议

• 使用 --headless
• 避免 root 直接运行（可建普通用户）
• 可用 libreoffice --headless --convert-to pdf 写脚本或 API

如果你有：

• 具体文件类型（docx / xlsx / pptx / odt）
• 是否在服务器 / Docker
• 是否需要中文字体支持

可以告诉我，我可以给你更精确的方案。