Docker中CentOS环境下PhantomJS字体格式问题解决咨询

我之前在CentOS容器里跑PhantomJS转PDF也遇到过一模一样的字体问题！核心原因是CentOS基础镜像默认只带了极少的字体，PhantomJS找不到合适的字体就会用奇怪的 fallback 字体，导致渲染出来的PDF可读性极差。下面是我亲测有效的解决方法：

1. 在Dockerfile中安装必要的字体和字体管理工具 #

CentOS默认没有预装常用的易读字体，所以第一步要在镜像里装上。推荐安装Liberation字体族——这是一套开源的无衬线字体，和Arial、Helvetica等常用字体高度兼容，渲染出来的文本非常清晰。同时安装fontconfig来让系统正确识别字体：

# 安装Liberation字体和fontconfig
RUN yum install -y liberation-fonts fontconfig \
    && yum clean all  # 清理yum缓存，减小镜像体积

如果你的PDF需要支持中文，再额外安装文泉驿微米黑（一款优秀的开源中文字体）：

RUN yum install -y wqy-microhei-fonts \
    && yum clean all

2. 在HTML中指定字体族 #

安装完字体后，需要在你的HTML里明确指定使用这些已安装的字体，避免PhantomJS自动选择奇怪的 fallback 字体。可以直接用内联样式，或者全局CSS：

• 内联样式示例：

<p style="font-family: 'Liberation Sans', Arial, sans-serif;">这是一段测试文本</p>

• 全局CSS示例（放在<style>标签里）：

body {
    font-family: 'Liberation Sans', Arial, sans-serif;
}

Liberation Sans是我们刚安装的字体，后面的Arial和sans-serif是降级方案，确保在任何环境下都有可用的无衬线字体。

3. 验证字体是否正确安装 #

构建完镜像后，可以进入容器运行以下命令，确认字体已经被系统识别：

fc-list | grep Liberation

如果能看到Liberation字体的列表，说明安装成功了。

额外提示 #

如果你的HTML需要使用自定义字体（比如品牌字体），可以把字体文件（.ttf/.otf等）复制到容器的/usr/share/fonts目录下，然后运行fc-cache -fv更新字体缓存，再通过CSS的@font-face引入即可。

这样处理后，PhantomJS渲染出来的PDF字体就会清晰易读，和你预期的效果一致啦！

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