FontSubset

English | 中文

当前版本是使用 Rust 完整重构的桌面字体裁剪工具，基于 HarfBuzz Subset、 GPUI 和 GPUI Component 实现，性能高、内存占用小。 GUI 为原生渲染，不使用 Electron、Tauri 或任何其他 WebView 套壳方案。 完整支持直接裁剪 TrueType 和 PostScript（CFF/CFF2）轮廓字体， 无需转换字体格式或进行其他额外操作。

Rust 版新增支持： legacy/ 中的旧 C#/Avalonia 版本只能裁剪 TrueType 轮廓，不能裁剪 PostScript 字体。当前 Rust 版本已经支持带 PostScript CFF/CFF2 轮廓的 .otf 字体，并会直接裁剪，无需先转换为 TTF。

功能

• 支持 .ttf 和 .otf，包括采用 PostScript 轮廓的 .otf
• 支持 TrueType glyf 轮廓
• 支持 PostScript CFF、CID-keyed CFF 和可变 CFF2 轮廓
• 递归扫描字符集目录，并按正则表达式匹配文本文件
• 可保留可见 ASCII 字符，可移除 TrueType 和 CFF/CFF2 Hinting
• 支持反选裁剪：给定源字体 A 和选中字符裁出的 sub_A，一键得到差集字体 B = A - sub_A（即源字体中除选中字符外的全部剩余字符）
• 默认保留 GSUB、GPOS 和 GDEF 等复杂布局表
• 严格验证输出 cmap 只包含源字体支持的目标字符
• GUI 和 console 共用同一套 fontsubset-core 实现
• 高性能、低内存占用的原生 GPUI 界面，不依赖 Electron、Tauri 或 WebView
• GUI 支持拖入字体、中文和英文实时切换，耗时裁剪在后台线程执行

独立 Type 1 .pfa 和 .pfb 文件不是 OpenType 字体，当前不直接接受。 请先转换为 OpenType CFF。OpenType CFF/CFF2 会直接裁剪，不需要转成 TTF。

截图

GUI 使用

1. 将 .ttf 或 .otf 拖入窗口，也可以点击“选择”指定输入字体。
2. 输入字体确定后会自动建议输出路径，也可以手动修改。
3. 字符集文件目录是可选项。选择后会递归读取其中匹配正则表达式的文件。
4. 如果不选择字符集目录，必须勾选“保留 ASCII 字符”；如果只想保留目录文件中出现的字符，请取消该选项。
5. 按需设置自定义正则、移除 Hinting 或反选裁剪，然后点击“开始裁剪”。

标题区的 中 / EN 按钮可以切换界面语言。GSUB、GPOS 和 GDEF 等布局表始终保留，以避免破坏字体排版和复杂文字塑形。

选项说明

• 保留 ASCII 字符：无论字符集文件中是否出现，都会额外保留 U+0020 至 U+007E。适合英文、数字和常用符号；想严格按字符集文件裁剪时应取消勾选。该选项是在选字符之后叠加的后处理，不受“反选裁剪”影响，勾选后无论正选还是反选都会保留 ASCII。
• 移除 Hinting：删除用于小字号像素对齐的 TrueType 指令以及 CFF/CFF2 hint 信息，可以进一步减小字体，但旧版 Windows 或低分辨率下的小字号可能变模糊、笔画不均。现代高 DPI 屏幕、macOS 和较大字号通常影响较小。GUI 默认不勾选；只有明确优先考虑体积且能接受显示差异时再启用。该选项对正选和反选裁剪都一样生效。
• 反选裁剪（生成差集 B = A - sub_A）：勾选后，输出字体将包含源字体中除本次选中字符外的其余全部字符，即源字体减去正常裁剪结果得到的差集字体。若同时需要 sub_A 和差集字体 B，请分别关闭和启用此选项各运行一次，输出到不同的文件。

Console 使用

从目录中的匹配文件收集字符：

fontsubset-console -c examples/input_text -a examples/IMPACT.TTF output.ttf

直接指定文本：

fontsubset-console --text "你好，世界" input.otf output.otf

生成差集字体 B = A - sub_A（源字体减去正常裁剪结果，即除选中字符外的全部剩余字符）：

fontsubset-console --text "你好，世界" --remainder input.otf remainder.otf

若同时需要 sub_A 和差集字体 B，运行两次，分别去掉和加上 --remainder， 指定不同的输出文件即可。--ascii 和 -s/--strip-hints 在两种模式下 效果一致：ASCII 字符始终作为后处理叠加保留，不受 --remainder 影响； Hinting 移除同样对两种模式生效。

兼容旧参数名称 --charsfile 和 --strip。使用 -s 或 --strip-hints 移除 TrueType 和 CFF/CFF2 Hinting。布局表始终保留。

自包含 HarfBuzz

HarfBuzz 11.2.0 Subset 已从 vendored 源码静态编译进 GUI 和 console。 Windows、Linux 和 macOS 用户都不需要安装 HarfBuzz、复制 DLL 或设置环境变量。 两个可执行文件会各自增加约 2 MB，但发布包可以直接运行，不依赖系统 HarfBuzz 版本。

构建

需要支持 Rust 2024 edition 的稳定版工具链。Windows 需要 MSVC 和 Windows SDK。 首次构建会下载 GPUI/Zed Git 依赖，耗时会较长。

cargo build --release --workspace

产物：

target/release/fontsubset-console.exe
target/release/fontsubset-gui.exe

运行 GUI：

cargo run -p fontsubset-gui

项目结构

src/
  harfbuzz-subset-sys/  # HarfBuzz Subset 静态 FFI 和 C++ 构建
  fontsubset-core/       # 字符收集、HarfBuzz 裁剪和严格结果验证
  fontsubset-console/    # 命令行前端
  fontsubset-gui/        # GPUI 界面和中英文资源
legacy/                  # 原 C#/Avalonia 实现及其构建文件
examples/                # 示例字体和字符集文件
vendor/harfbuzz/         # 固定版本 HarfBuzz 11.2.0 源码和许可证

测试

cargo fmt --all -- --check
cargo test --locked --workspace
cargo clippy --locked --workspace --all-targets -- -D warnings

项目已使用 TrueType、普通 CFF、CID-keyed CFF 和可变 CFF2 字体进行真实裁剪验证。

发布

推送 v* tag 会触发 GitHub Actions，构建 Windows、Linux 和 macOS 压缩包， 生成 SHA-256 校验文件并发布 GitHub Release。tag 版本必须与根目录 Cargo.toml 的 workspace 版本一致。

git tag v0.4.0
git push origin v0.4.0

GUI 和 console 会发布为独立下载包：

• fontsubset-gui-windows-x64.zip
• fontsubset-console-windows-x64.zip
• fontsubset-gui-linux-x64.tar.gz
• fontsubset-console-linux-x64.tar.gz
• fontsubset-gui-linux-arm64.tar.gz
• fontsubset-console-linux-arm64.tar.gz
• fontsubset-gui-macos-arm64.zip
• fontsubset-console-macos-arm64.tar.gz

macOS GUI 包中是标准 FontSubset.app，并进行了 ad-hoc codesign，但没有 Apple Developer ID 签名和公证。 如果 Gatekeeper 阻止首次运行，可以先尝试右键点击应用并选择“打开”，或者执行：

xattr -dr com.apple.quarantine FontSubset.app
open FontSubset.app

xattr -cr FontSubset.app 也能清除限制，但会删除应用上的全部扩展属性；只删除 com.apple.quarantine 更精确。要做到下载后直接双击且不出现警告，仍然需要 Developer ID 签名和 Apple notarization。

License

MIT