Source Han Sans TTF 字体构建与使用指南

Source Han Sans TTF 是一个专门用于构建思源黑体 TTF 版本的项目，该项目提供了高质量的 TTF 字体文件，并包含专业的 hinting 配置技术，确保在不同分辨率的屏幕上都能获得清晰的显示效果。

项目核心特性

开源免费商用

该项目基于开源协议，可以免费用于个人和商业项目，无需担心版权问题。字体文件包含了完整的版权信息，使用时建议保留这些信息以尊重开发者劳动成果。

全字重覆盖

项目提供 7 种不同字重的字体文件，满足各种设计需求：

• SourceHanSans-ExtraLight.ttc（超细体）
• SourceHanSans-Light.ttc（细体）
• SourceHanSans-Normal.ttc（标准体）
• SourceHanSans-Regular.ttc（常规体）
• SourceHanSans-Medium.ttc（中等体）
• SourceHanSans-Bold.ttc（粗体）
• SourceHanSans-Heavy.ttc（特粗体）

专业 hinting 技术

每个字重都有独立的 hinting 配置文件，位于 hint-config/ 目录下，这些配置文件针对不同文字系统进行了优化：

• 中日韩统一表意文字
• 平假名和片假名
• 韩文音节文字

安装与构建

环境要求

在开始构建之前，需要安装以下依赖：

• 最新版本的 AFDKO
• Node.js 运行环境

构建步骤

git clone https://gitcode.com/gh_mirrors/so/source-han-sans-ttf
cd source-han-sans-ttf
npm install
npm run build all

构建过程可能需要数小时，生成的字体文件将使用 "SHSTTF" 作为字体族名。

自定义字体名称

如果需要修改字体名称，可以编辑 config.json 文件中的 naming.FamilyName 条目（影响菜单显示名称）和 prefix 属性（影响文件名和 PostScript 名称），然后重新构建。

字体文件使用

系统安装

将生成的 TTC 文件复制到系统字体目录：

• Windows：C:\Windows\Fonts
• macOS：/Library/Fonts

安装前建议关闭正在运行的设计应用程序。

网页开发使用

通过 CSS 的 @font-face 规则引入字体：

@font-face {
  font-family: 'Source Han Sans';
  src: url('src/SourceHanSans-Regular.ttc') format('truetype');
  font-weight: 400;
  font-style: normal;
}

场景适配建议

UI 设计场景

• 标题文字：推荐使用 SourceHanSans-Bold.ttc 或 SourceHanSans-Heavy.ttc
• 按钮文字：SourceHanSans-Medium.ttc 提供良好的可点击性提示
• 正文内容：SourceHanSans-Regular.ttc 适合大多数阅读场景

印刷排版

• 书籍正文：SourceHanSans-Regular.ttc 笔画粗细适中，阅读舒适
• 杂志标题：根据风格选择 SourceHanSans-Bold.ttc 或 SourceHanSans-Heavy.ttc

移动端应用

• App 标题栏：SourceHanSans-Bold.ttc 在小屏幕上更醒目
• 内容列表：SourceHanSans-Regular.ttc 减轻阅读疲劳

常见问题解决

问题类型	解决方案
字体渲染模糊	调整 hint-config 目录下对应字重的 JSON 配置文件参数
字体安装失败	确保字体文件正确复制到系统字体目录，重启应用
CSS 引入不生效	检查字体文件路径是否正确
字重选择不当	参考场景适配建议重新选择合适字重

技术配置说明

项目的 hinting 配置针对不同文字系统进行了专门优化：

• 中日韩统一表意文字使用特定的轮廓处理参数
• 平假名和片假名有独立的斜率模糊设置
• 支持多种 OpenType 特性追踪

通过专业的 hinting 技术，确保了字体在各种显示环境下都能保持最佳的视觉效果。