在 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'
]

这三个参数的作用：

• --font-render-hinting=medium：控制字体提示精度。
• --disable-font-subpixel-positioning：禁用亚像素定位，避免模糊。
• --font-cache-limit=1024：扩大字体缓存上限，防止中文字体加载不全。

如果服务器上已经部署了 Noto Sans CJK SC 字体，可以再加一句：'--font-path=/usr/share/fonts/truetype/noto'，显式告诉 Chrome 去哪里找字体。

《夸克》非常好用的免费AI浏览器

下载APP查看