Sarasa-Gothic构建环境配置终极指南：Node.js、AFDKO、ttfautohint完全教程
项目地址: https://gitcode.com/gh_mirrors/sa/Sarasa-Gothic Sarasa-Gothic（更纱黑体）是一款优秀的CJK复合字体，基于Inter、Iosevka和Source Han Sans构建而成。想要成功构建这款字体，你需要正确配置Node.js、AFDKO和ttfautohint三大核心工具。本教程将为你提供详细的步骤说明，确保你能够顺利完成Sarasa-Gothic的构建环境配置。🚀
必备工具清单
在开始构建之前，请确保你的系统已安装以下三个关键工具：
- Node.js 20或更新版本 - 项目的JavaScript运行环境
- AFDKO（Adobe Font Development Kit for OpenType） - 字体开发工具包
- ttfautohint - TrueType字体自动提示工具
环境检测与验证
项目内置了环境检测脚本 check-env.mjs，它会自动检查otc2otf和otf2ttf命令是否可用。这些命令是AFDKO工具包的重要组成部分。
快速安装步骤
1. 克隆项目仓库
git clone https://gitcode.com/gh_mirrors/sa/Sarasa-Gothic
cd Sarasa-Gothic
2. 安装依赖包
npm install
3. 构建字体文件
构建TTF格式：
npm run build ttf
构建TTC格式：
npm run build ttc
构建输出说明
- TTF文件：输出到
out/ttf目录 - TTC文件：输出到
out/ttc目录
⚠️ 重要提醒：构建TTC文件需要大量内存，因为存在大量的子家族-正字法组合。
字体家族详解
Sarasa-Gothic包含8个主要字体家族：
- Gothic - 标准黑体样式
- UI - 用户界面优化版本
- Mono - 等宽字体版本
- Term - 终端专用版本
- Fixed - 固定宽度版本
- MonoSlab - 等宽衬线版本
- TermSlab - 终端衬线版本
- FixedSlab - 固定宽度衬线版本
正字法变体
项目支持多种地区正字法：
CL- 古典正字法SC- 简体中文TC- 繁体中文HC- 香港繁体J- 日文K- 韩文
常见问题解决
如果遇到构建失败，请检查：
- Node.js版本是否符合要求（≥20.0.0）
- AFDKO是否正确安装且命令可用
- 系统内存是否充足（特别是构建TTC时）
配置管理
项目的主要配置存储在 config.json 文件中，包含字体家族定义、样式顺序、命名规则等重要设置。构建脚本 verdafile.mjs 负责整个构建流程的协调。
通过本指南，你应该能够成功配置Sarasa-Gothic的构建环境，并开始创建自己的字体变体。记得在安装新版本前完全移除旧版本字体，以避免系统缓存问题。🎯
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
