谷歌浏览器为什么无法在Linux环境下正确渲染中文字体？

谷歌浏览器在Linux下中文字体渲染异常，首要原因是系统缺失中文字体（fc-list :lang=zh无输出），其次为Chrome 140+与损坏字体（如HEJI2Text.otf）冲突、SimSun粗体映射失效及Puppeteer未配置字体路径所致。

谷歌浏览器在Linux环境下无法正确渲染中文字体，是因为系统缺少预装的中文字体文件、Puppeteer启动参数未指定字体路径、网页CSS未配置中文字体回退链，以及Chrome 140版本引入的Fontations字体索引系统与某些损坏字体（如HEJI2Text.otf）发生冲突，导致文字显示为方块、模糊或完全空白。

验证系统是否缺失中文字体

打开终端，执行命令：fc-list :lang=zh。

若返回为空，说明系统未安装任何中文字体——【这是最常见且必须优先解决的前提】。

若返回结果中包含“Noto Sans CJK SC”“WenQuanYi Zen Hei”等字样，则字体已存在，问题可能出在渲染配置或冲突字体上。

卸载引发崩溃的异常字体文件

Chrome 140+ 在 Linux 上会因特定损坏字体触发渲染中断甚至崩溃。先检测是否存在高危字体：

运行命令：fc-list -f "%{file}n" | grep -Ei 'unitwebrbw03medium.ttf|unitwebrbw03light.ttf|panton_black.otf|heji2text.otf'。

只要输出任意一行路径，就说明该字体已安装并正在干扰渲染——【必须立即删除对应.ttf或.otf文件，否则后续所有配置均无效】。

删除后执行 sudo fc-cache -fv 刷新字体缓存。

强制替换宋体粗体为可用字体

Linux 下 SimSun（宋体）本身不含粗体字重，Chrome 渲染 font-weight: bold 时会失真或发虚。需通过 fontconfig 规则硬性映射：

第一步：用 sudo 权限在 /etc/fonts/conf.d/ 目录下新建文件 s99-local.conf；

第二步：写入以下 XML 内容（注意第6、7、11、12行的 family 名称必须与开发者工具中实际捕获的一致）：

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "fonts.dtd">
<fontconfig>
  <match target="pattern">
    <test name="family"><string>Simsun</string></test>
    <test name="weight" compare="more_eq"><const>bold</const></test>
    <edit name="family" mode="assign"><string>Microsoft YaHei</string></edit>
  </match>
  <match target="pattern">
    <test name="family"><string>宋体</string></test>
    <test name="weight" compare="more_eq"><const>bold</const></test>
    <edit name="family" mode="assign"><string>Microsoft YaHei</string></edit>
  </match>
</fontconfig>

第三步：保存文件，执行 sudo fc-cache -fv 生效；

第四步：重启 Chrome 或整个系统——只有重启才能让 Chromium 进程加载新 fontconfig 规则。

修改 Puppeteer 启动参数（适用于 url-to-pdf-api 场景）

如果你使用的是基于 Puppeteer 的服务（例如 url-to-pdf-api），仅改系统字体不够，还需让 Chrome 实例主动识别字体路径：

编辑 src/core/render-core.js 文件，在 createBrowser(opts) 函数的 browserOpts 对象中添加：

args: ['--font-render-hinting=medium', '--disable-font-subpixel-positioning', '--font-cache-limit=1024']；

这三组参数分别控制字体提示精度、禁用亚像素定位（避免模糊）、扩大字体缓存上限（防止中文字体加载不全）。

若服务器部署了 Noto Sans CJK SC 字体，可追加：--font-path=/usr/share/fonts/truetype/noto 显式声明路径。