Rust 字体子集化工具一览

背景

Python 的 fontTools + pyftsubset 是字体子集化的标准方案，但依赖 Python 环境、体积大、速度慢。如果你在用 Rust 技术栈（或只是不想装 Python），以下工具可以直接替代。

1. font_subset — 纯 Rust 库，最轻量

用法：

1
use font_subset::{Font, FontReader};
2

3
let font: Font = FontReader::new(font_bytes)?.read()?;
4
let subset = font.subset(&retained_chars)?; // 只保留指定字符
5
let woff2: Vec<u8> = subset.to_woff2();

适合嵌入构建脚本或 WASM 场景，零外部依赖。

2. font-convert — 命令行最省事

用法：

1
font-convert --input 字体.ttf \
2
             --text "你的网站所有文字内容" \
3
             --output subset.woff2

不需要写代码，也不需要 Python。直接把用到的汉字丢进去，出来就是精简后的字体文件。

3. fontcull / fontcull-cli — 自动爬站裁剪

用法：

1
fontcull https://你的站点.com --subset=fonts/*.ttf

适合已有线上站点、想全自动优化字体体积的场景。它会分析 CSS content 伪元素里的 Unicode，不漏掉图标字体。

4. allsorts — 功能最全

如果你需要完整的字体处理管线（不只是裁剪，还要做 shaping、特征表处理），allsorts 是目前 Rust 生态里最成熟的方案。

5. cn-font-split — 中文特化

中文字体动辄 10MB+，cn-font-split 会把字体按 Unicode 范围拆成多个小文件，配合 unicode-range 实现按需加载，比单文件子集化更极致。

选型建议

与 Ateλier 的关联

Ateλier 原版的 fonts:ui 脚本用 Python fontTools 裁剪 UI 字体。如果你不想装 Python，可以用 font-convert 替代：

1
# 原版（需 Python）
2
bun run fonts:ui
3

4
# 替代（纯 Rust）
5
font-convert --input src/assets/fonts/ui-font.ttf \
6
             --text "首页所有文案内容" \
7
             --output public/fonts/ui-font.subset.woff2

然后在 src/config/site.toml 里把字体路径指向裁剪后的文件即可。