轻松上手思源黑体字体转换：TTF格式生成全攻略

思源黑体作为一款广泛使用的开源字体，其字体文件转换过程对许多开发者而言至关重要。本指南将带你从零开始，通过简单几步完成TTF格式字体的生成与定制，让专业字体处理变得触手可及。

一、准备工作：环境搭建与依赖安装

1.1 必要工具安装

在开始字体转换前，请确保系统已安装以下工具：

• AFDKO（最新版本）：Adobe字体开发工具包，用于字体文件处理
• Node.js：运行JavaScript构建脚本的运行环境

💡 小贴士：AFDKO可通过Adobe官方渠道获取，Node.js推荐使用v14+版本以确保兼容性。

1.2 项目结构解析

graph TD
    A[source-han-sans-ttf] --> B[LICENSE]
    A --> C[README.md]
    A --> D[config.json]
    A --> E[package.json]
    A --> F[hint-config/]
    A --> G[renaming/]
    A --> H[src/]
    A --> I[verdafile.js]
    F --> J[Bold.json]
    F --> K[ExtraLight.json]
    F --> L[...]
    G --> M[index.js]
    H --> N[SourceHanSans-Bold.ttc]
    H --> O[SourceHanSans-ExtraLight.ttc]
    H --> P[...]

核心目录说明：

• src/：存放原始字体文件（.ttc格式）
• hint-config/：包含各字重的字体 hinting 配置
• renaming/：字体重命名脚本目录
• config.json：项目核心配置文件，控制字体命名与生成参数

二、操作步骤：TTF字体生成全流程

2.1 获取项目代码

首先克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/so/source-han-sans-ttf.git
cd source-han-sans-ttf

2.2 安装项目依赖

执行以下命令安装Node.js依赖包：

npm install

💡 小贴士：若安装过程中出现权限问题，可尝试添加--unsafe-perm参数或使用sudo执行。

2.3 执行构建命令

运行构建脚本生成所有字重的TTF字体：

npm run build all

构建过程说明：

1. 脚本会自动处理src/目录下的原始字体文件
2. 应用hint-config/中的hinting配置
3. 生成的TTF文件将按config.json中的命名规则输出

💡 小贴士：完整构建可能需要数小时，请确保电脑在构建过程中保持开机状态。可通过添加特定字重参数（如npm run build bold）只构建所需字体。

三、高级定制：字体名称与参数调整

3.1 修改字体家族名称

如需自定义生成的字体家族名称，可编辑config.json文件：

{
  "naming": {
    "familyName": {
      "en_US": "MyCustomFont",
      "zh_CN": "我的自定义字体",
      // 其他语言配置...
    }
  }
}

3.2 调整文件命名前缀

修改config.json中的prefix字段可改变输出文件的命名前缀：

{
  "prefix": "CustomPrefix"  // 默认值为"ShsTtf"
}

💡 小贴士：修改配置后需重新执行npm run build all命令才能使更改生效。所有自定义设置建议在首次构建前完成。

四、注意事项与许可证说明

4.1 构建性能优化

• 单字重构建：使用npm run build <weight>命令（如npm run build bold）
• 后台运行：在服务器环境可使用nohup npm run build all &避免终端关闭中断构建

4.2 许可证合规说明

本项目基于开源许可证发布，使用时需遵守以下原则：

• 允许个人与商业用途
• 修改后的字体文件需保留原始许可证信息
• 分发时需包含LICENSE文件

💡 小贴士：详细许可证条款请查阅项目根目录下的LICENSE文件，任何商业分发前建议咨询法律专业人士。

五、常见问题解决

5.1 构建失败处理

若出现AFDKO not found错误：

1. 确认AFDKO已正确安装并添加到系统PATH
2. 重启终端或重新登录系统使环境变量生效

5.2 字体文件无法使用

生成的TTF文件若在应用中无法识别：

• 检查字体文件完整性（文件大小不为0）
• 尝试使用FontForge等工具验证文件结构
• 确认目标应用支持TTF格式字体

💡 小贴士：遇到复杂问题可查看项目GitHub Issues或提交新issue获取社区支持。

通过以上步骤，你已掌握思源黑体TTF格式的完整生成流程。如需进一步定制字体参数，可查阅config.json中的详细配置项或参考项目README.md获取高级用法。