LibreOffice转PDF中文乱码如何解决？

Question

在使用LibreOffice将含中文文本的文档转换为PDF时，常出现中文乱码或方框问号现象。该问题多因系统缺失中文字体或LibreOffice未正确嵌入字体所致。尤其是在Linux等开源系统中，默认未安装完整中文字体包（如WenQuanYi、Noto Sans CJK），导致渲染失败。此外，文档样式中指定的中文字体在目标环境中不可用，也会引发乱码。如何确保中文字体正确识别并嵌入PDF输出，是解决此问题的关键技术难点。

Answer 1

一、问题现象与背景分析

在使用LibreOffice将含中文文本的文档（如.odt或.docx）转换为PDF时，常出现中文显示为方框、问号或乱码的现象。该问题在Linux系统中尤为普遍，主要由于系统未预装完整中文字体包所致。

典型表现包括：

• 文档中中文字符在LibreOffice界面正常显示，但导出PDF后变为“□”或“”
• 字体名称显示为“Unknown Font”或“Missing Glyph”
• 部分字体如“宋体”、“黑体”无法正确映射到可用字体

此问题的根本原因可归结为两个层面：系统级字体缺失与应用层字体嵌入机制缺陷。

二、技术成因深度剖析

从底层机制来看，PDF文件本身不存储字体数据，除非显式嵌入。LibreOffice在导出PDF时，默认仅嵌入文档中实际使用的字形子集，且依赖系统字体配置进行映射。

常见成因如下表所示：

成因类别	具体描述	影响范围
系统字体缺失	Linux发行版默认未安装Noto Sans CJK或WenQuanYi等开源中文字体	所有用户
字体路径未注册	字体存在于文件系统但未被fontconfig识别	高级用户/容器环境
字体替换策略不当	LibreOffice自动替换为无中文支持的英文字体	样式复杂文档
PDF嵌入选项关闭	未启用“嵌入所用字符”选项	跨平台分发场景

三、诊断流程与检测方法

为精准定位问题，建议按以下流程进行排查：

# 1. 检查系统是否识别中文字体
fc-list :lang=zh | grep -i "noto\|wqy"

# 2. 验证LibreOffice当前可用字体
libreoffice --headless --convert-to pdf /dev/null 2>&1 | grep -i font

# 3. 查看PDF字体嵌入状态（需安装poppler-utils）
pdfinfo -font output.pdf
    

通过上述命令可确认字体是否被系统识别、LibreOffice是否加载以及最终PDF是否嵌入中文字符集。

四、解决方案体系构建

针对不同层级的问题，需采取多维度解决策略：

1. 安装完整中文字体包：
   • Ubuntu/Debian: sudo apt install fonts-noto-cjk fonts-wqy-zenhei
   • CentOS/RHEL: yum install google-noto-sans-cjk-ttc-fonts
2. 配置LibreOffice字体替换规则： 进入“工具 → 选项 → LibreOffice → 字体”，启用“使用替换表”，将“SimSun”映射至“Noto Serif CJK SC”。
3. 强制嵌入字体导出PDF： 在“另存为PDF”对话框中，勾选“嵌入字体”并选择“嵌入所用字符”。
4. 脚本化自动化处理： 使用unoconv或libreoffice --headless命令行模式，并确保运行环境已配置字体。

五、高级部署与持续集成场景优化

在CI/CD流水线或Docker容器中，需确保构建镜像包含必要字体资源。示例如下：

FROM ubuntu:22.04
RUN apt update && apt install -y \
    libreoffice-writer \
    fonts-noto-cjk \
    fontconfig
RUN fc-cache -fv
    

此外，可通过设置环境变量控制LibreOffice行为：

export SAL_DISABLE_DEFAULT_FONT_SUBSTITUTION=1

以防止意外字体替换。

六、可视化处理流程图

以下是完整的中文字体PDF输出保障流程：

graph TD
            A[源文档含中文] --> B{系统是否安装中文字体?}
            B -- 否 --> C[安装Noto/WenQuanYi字体]
            B -- 是 --> D[LibreOffice打开文档]
            C --> D
            D --> E{字体是否正确渲染?}
            E -- 否 --> F[配置字体替换规则]
            E -- 是 --> G[导出PDF前检查嵌入选项]
            F --> G
            G --> H[勾选'嵌入所用字符']
            H --> I[生成PDF]
            I --> J[使用pdfinfo验证字体嵌入]