Alpine Linux Docker容器中Puppeteer字体显示异常问题求助

这个问题的核心是安装IPA字体后，它被Chromium当作默认无衬线字体优先使用，导致英文显示效果拉胯。我们可以通过安装合适的英文字体+配置fontconfig字体规则来让不同语言匹配对应字体，完美解决这个矛盾。

步骤1：安装必要的字体与字体管理工具 #

首先安装fontconfig（用来管理字体优先级）、英文常用的ttf-freefont，以及日文的font-ipa：

apk add --no-cache fontconfig ttf-freefont font-ipa@edge

步骤2：配置fontconfig字体匹配规则 #

创建自定义字体配置文件，让Chromium对英文和日文分别使用对应的字体。在容器中创建/etc/fonts/local.conf文件，写入以下内容：

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
  <!-- 让英文优先使用FreeSans（ttf-freefont中的无衬线字体） -->
  <match target="pattern">
    <test qual="any" name="lang">
      <string>en</string>
    </test>
    <test name="family">
      <string>sans-serif</string>
    </test>
    <edit name="family" mode="prepend" binding="strong">
      <string>FreeSans</string>
    </edit>
  </match>

  <!-- 让日文优先使用IPAexゴシック -->
  <match target="pattern">
    <test qual="any" name="lang">
      <string>ja</string>
    </test>
    <test name="family">
      <string>sans-serif</string>
    </test>
    <edit name="family" mode="prepend" binding="strong">
      <string>IPAexゴシック</string>
    </edit>
  </match>
</fontconfig>

步骤3：更新字体缓存 #

执行以下命令让fontconfig加载新配置并更新缓存：

fc-cache -fv

验证效果 #

重启你的Puppeteer服务，现在应该能看到：

• 英文内容用FreeSans正常渲染，不会再用IPA字体的奇怪英文样式
• 日文内容用IPA字体正常显示，不会出现方块或缺失

如果还遇到个别字体问题，可以检查fc-match sans-serif命令的输出，确认默认无衬线字体的优先级是否正确，或者调整配置文件里的字体顺序。

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