Typst项目中的CJK可变字体兼容性问题解析

在最新发布的Typst 0.12版本中，用户报告了一个关于CJK(中日韩)字体渲染的重要问题。当使用可变字体时，PDF输出会出现"豆腐块"(tofu)现象，而SVG输出则表现正常。这个问题在0.11.1版本中并不存在，引起了用户社区的广泛关注。

问题本质分析

经过技术团队的深入调查，发现问题根源在于可变字体的处理机制。Typst 0.12版本对可变字体的支持存在缺陷，特别是在PDF输出格式下。这种现象在CJK字体上表现得尤为明显，因为CJK字符集通常包含大量字形，对字体引擎的要求更高。

技术细节

1. 静态字体与可变字体差异：

   • 静态字体：每个字重和样式都是独立的字体文件
   • 可变字体：单个文件包含多个字重和样式的连续变化

2. 渲染表现差异：

   • PDF输出：0.12版本无法正确处理可变字体的字形替换
   • SVG输出：由于使用不同的渲染路径，表现正常
   • PNG输出：0.12版本反而比0.11.1版本有更好的渲染质量

解决方案

目前推荐的解决方案是使用静态CJK字体。例如Noto Serif CJK的静态版本可以完美工作。技术团队已经意识到这个问题的重要性，并计划在未来版本中完善对可变字体的支持。

开发者建议

对于开发者而言，在处理多语言文档时应当注意：

1. 优先选择经过充分测试的静态字体
2. 对于CJK内容，建议使用专门的CJK字体而非通用字体
3. 在不同输出格式(PDF/SVG/PNG)下进行交叉验证

Typst团队已经将此问题记录为技术债务，并将在后续版本中改进字体处理引擎，特别是对可变字体的支持。这个案例也提醒我们，在全球化软件开发中，多语言支持需要特别关注字体渲染等细节问题。