Python FontTools 字体子集自动生成工具：核心脚本与EXE打包实践

脚本专家

在游戏开发、UI 设计或嵌入式项目中，原始字体文件往往包含大量未使用的字符，导致包体臃肿。通过 Python 结合 FontTools 库，可以自动提取文本中的可见字符并生成精简后的字体子集，大幅缩小体积。下面一步步搭建这个工具。

一、项目环境搭建

创建项目目录并进入：

2. cd /d F:\tools\fonttools

复制代码

使用 Python 内置的 venv 创建虚拟环境：

2. python -m venv venv

复制代码

激活虚拟环境（Windows）：

2. venv\Scripts\activate

复制代码

命令行出现 (venv) 前缀表示成功。

安装依赖：

2. pip install fonttools pyinstaller

复制代码

验证 FontTools 可正常调用：

2. python -c "from fontTools.subset import main; print('OK')"

复制代码

输出 OK 说明环境就绪。

二、核心脚本：font_subset_core.py

该脚本负责读取文本、去重排序、生成字符集文件，并调用 pyftsubset 生成子集字体。完整代码如下：

2. import sys
3. from pathlib import Path
4. from fontTools.subset import main as pyftsubset_main
6. FONT_EXTS = {".ttf", ".otf"}
8. def read_text_auto(path):
9.     """自动尝试多种编码读取文本文件"""
10.     data = Path(path).read_bytes()
11.     for enc in ("utf-8-sig", "utf-8", "gbk", "gb18030"):
12.         try:
13.             return data.decode(enc), enc
14.         except UnicodeDecodeError:
15.             pass
16.     return data.decode("gb18030", errors="ignore"), "gb18030-ignore"
18. def sort_key(c):
19.     code = ord(c)
20.     if '0' <= c <= '9':
21.         return (0, code)
22.     if 'A' <= c <= 'Z':
23.         return (1, code)
24.     if 'a' <= c <= 'z':
25.         return (2, code)
26.     if 0x4E00 <= code <= 0x9FFF:
27.         return (4, code)
28.     return (3, code)
30. def make_unique_chars(text):
31.     chars = {c for c in text if not c.isspace() and ord(c) >= 32}
32.     return "".join(sorted(chars, key=sort_key))
34. def build_subset(font_path, chars_path, out_font_path):
35.     pyftsubset_main([
36.         str(font_path),
37.         f"--text-file={chars_path}",
38.         f"--output-file={out_font_path}",
39.         "--layout-features=*",
40.         "--glyph-names",
41.         "--symbol-cmap",
42.         "--legacy-cmap",
43.         "--notdef-glyph",
44.         "--notdef-outline",
45.         "--recommended-glyphs",
46.     ])
48. def main():
49.     if len(sys.argv) < 3:
50.         print("用法: font_subset_core.exe 字体.ttf 文本.txt")
51.         return
52.     font_path = Path(sys.argv[1])
53.     text_path = Path(sys.argv[2])
54.    
55.     if not font_path.exists():
56.         print("字体文件不存在:", font_path)
57.         return
58.     if not text_path.exists():
59.         print("文本文件不存在:", text_path)
60.         return
61.     if font_path.suffix.lower() not in FONT_EXTS:
62.         print("第一个参数必须是字体文件:", font_path)
63.         return
64.    
65.     text, enc = read_text_auto(text_path)
66.     chars = make_unique_chars(text)
67.     chars_path = text_path.with_name(text_path.stem + "_chars.txt")
68.     chars_path.write_text(chars, encoding="utf-8")
69.     out_font_path = font_path.with_name(font_path.stem + "_subset" + font_path.suffix)
70.     build_subset(font_path, chars_path, out_font_path)
71.    
72.     print("处理完成")
73.     print("识别编码 :", enc)
74.     print("字符数量 :", len(chars))
75.     print("字符文件 :", chars_path)
76.     print("子集字体 :", out_font_path)
78. if __name__ == "__main__":
79.     main()

复制代码

关键函数说明：

• read_text_auto：依次尝试 UTF-8 with BOM、UTF-8、GBK、GB18030 解码，保证中文文本兼容。
  
• sort_key：将字符排序为数字、大写字母、小写字母、其他字符、CJK 汉字（按 Unicode 码位），输出符合日常阅读习惯。
  
• make_unique_chars：过滤空白和控制字符，返回去重排序后的字符串。
  
• build_subset：封装 pyftsubset 命令，保留所有布局特性、字形名称、符号映射及推荐字形。
  

三、运行测试

在虚拟环境中执行：

2. python font_subset_core.py test.ttf test.txt

复制代码

测试结果示例：

2. 处理完成
3. 识别编码 : utf-8-sig
4. 字符数量 : 247
5. 字符文件 : test_chars.txt
6. 子集字体 : test_subset.ttf

复制代码

过程自动完成：读取文本 → 去重排序 → 生成 chars.txt → 调用 pyftsubset → 生成 subset.ttf。

四、打包为独立 EXE

方便在没有 Python 环境的目标机器上直接运行，使用 PyInstaller 打包：

2. python -m PyInstaller -F --clean --collect-all fontTools --name FontSubset font_subset_core.py

复制代码

参数含义：

• -F：生成单个 exe 文件。
  
• --clean：清理上次打包缓存。
  
• --collect-all fontTools：强制收集 FontTools 全部模块及依赖。
  
• --name：指定输出 exe 名称。
  

打包后得到 dist/FontSubset.exe。使用方式：

2. FontSubset.exe FZBWKS.ttf all_text.txt

复制代码

执行后会在同目录生成 all_text_chars.txt（字符集）和 FZBWKS_subset.ttf（子集字体）。适用于传奇游戏、手游项目、UI 字体优化等场景，可大幅缩小字体体积。

五、补充：字体加粗处理

生成的子集字体可能需要加粗效果。可以借助 FontForge 工具手动调整：

1. 打开生成的 subset.ttf。
2. 按 Ctrl+A 全选所有字形。
3. 选择菜单“元素 → 字体加粗”，设置加粗单位（如 6 em units），中文字体建议保留间距。
4. 导出为字体文件即可。

此步骤属于字体后期微调，与 Python 脚本配合即可完成完整字体优化流程。

六、总结

本工具通过 Python + FontTools 实现了从文本到字体子集的自动化生成，支持 .ttf / .otf 格式。借助 PyInstaller 打包后可直接运行，无需额外环境。对于需要精简字体体积的项目，是一个实用的脚本方案。

热心网友7

感谢分享！这个工具很实用，尤其是在游戏和UI开发中，字体子集化能显著减小包体。代码逻辑清晰，自动编码检测和字符排序考虑得很周全。我有个小建议：排序函数里对中文只按Unicode排序，如果能在保持分组的基础上按拼音或笔画排序，生成的字表可读性会更好（不过对于工具本身功能影响不大）。另外，打包成exe后方便非Python用户直接使用，这点很贴心。收藏了，回头试一下。