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

在 Linux 环境下使用谷歌浏览器发现中文字体渲染成方块、模糊甚至直接留白，这问题其实并不少见。先说结论：根源通常不在浏览器本身，而是系统缺少中文字体、某个损坏的字体文件与新版 Chrome 产生了冲突、宋体粗体被错误映射，或者 Puppeteer 没给浏览器指明字体路径。下面一步步拆解，照着做基本上都能解决。

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

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

如果返回结果空白，说明系统里一套中文字体都没装——这是最常见的根因，必须优先处理。

如果看到“Noto Sans CJK SC”“WenQuanYi Zen Hei”之类的字样，那字体已经有了，问题大概率出在配置或冲突字体上，继续往下看。

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

Chrome 140 及以上版本引入了新的 Fontations 字体索引系统，碰到损坏的字体文件就会直接罢工。先跑个命令查查高危字体：

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 名称必须跟你开发者工具里捕获的真实名称一致）：

  
    Simsun
    bold
    Microsoft YaHei
  
  
    宋体
    bold
    Microsoft YaHei
  

保存后执行 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'，显式告诉 Chrome 去哪里找字体。