自己的项目怎么嵌入字体
给 Markdown Marker 做文章字体选择器时,我想加几款自己愿意拿来读长文的字。选中仓耳今楷后,正文和标题都应该换过去,标题还得看得出加粗。仓耳官网有字库可以下载,但这中间有两个决定要自己做。一是用户从哪里拿到文件,二是浏览器怎样在两份今楷文件里选一份来画标题。
做自己项目的字体时,我会先用一款明确允许随应用分发的字体跑通这两步。后面再加需要用户下载或安装的字体,既有能离线工作的默认选项,也能沿用同一套字重和回退规则。
先决定字体文件由谁交付
我最初想把喜欢的字体都放进推荐列表,有下载地址就让应用去取。真正要发给别人时,先得写清楚谁在提供字库、用户在哪里取得它、文件会不会跟着项目或导出的文档一起走。网页把字体放在自己的静态服务器,和桌面应用把字体放进安装包,在工程上是两条链路,但都会由项目向用户交付字库。
- 随包或随网页提供。默认字体需要开箱即用时,我会选明确允许这种分发的版本,把原文件和许可一起交付。思源黑体的发布包使用 SIL Open Font License,允许随软件分发和作为网页字体提供。若项目还要做子集或转换格式,要查该版本声明的保留字体名称,以及 OFL 对修改和保留名称的要求。
- 用户从权利人提供的入口获取。可选字体可以在用户选择时再取,获取方式还要看具体条款。仓耳云黑产品页写明个人非商业使用可免费下载。方正个人非商用协议则规定了取得渠道、安装和屏幕显示的范围,并单列了将字库嵌入网站、程序等场景的书面许可要求。需要登录和同意许可时,可以让用户在官网完成这两步,再由桌面应用接收下载结果。
- 调用系统字体。如果官网要求通过官方客户端获取,或者还没确认应用内的获取方式,就提供官方入口。用户按许可安装后,在项目的字体选择器里选系统字体。应用只保存字体族名,设备缺少该字体时由回退字体接手。
汉仪个人非商用须知第二条分别写了个人从官网下载、本机调用,以及为研究、学习或欣赏复制到便携文件并展示的条件。项目向每位用户交付字库时,要另外核对这个动作。导出也要看实际产物。一个只保存字体族名的 HTML、一份嵌有字体数据的 PDF,以及一张把文字画成像素的图片,对字库文件的处理各不相同。
直链能返回完整的 TTF,证明的是这个地址当时可用。接入第三方下载站之前,我会查权利人是否授权该站提供字库,以及许可是否覆盖项目打算采用的获取方式。「关于」页可以留存来源,授权依据仍要回到权利人。美国版权局的 DMCA 第 512 节说明讲的是满足条件的服务商责任限制和通知移除机制,项目交付字体文件时仍需核对该字库的许可。
遇到「免费商用」的字样,我会去看授权列出的用途。方正客户端列有可以免费用于商业发布的字库,同一份说明把 App 嵌入和网页字库列在免费范围之外。正文或界面要开箱即用,可以先挑明确允许项目分发的版本。方正客户端授权说明 · 字库厂商与设计师授权速查弹窗
拿到 TTF 后先读文件内部的名字
下载下来的文件名经常是品牌名、缩写或版本号。应用展示的名称可以用中文,设置里持久化的名称则要跟 CSS 匹配。想知道系统或浏览器实际识别的是哪个字形,我会读 OpenType 的 name 表。字体族名用于把常规、粗体等字形组织在一起。完整字体名和 PostScript 名则能把同一家族的具体字形区分开,后者也适合核对 Chrome 实际绘制的文件。
用 python -m pip install fonttools 装好 fontTools 后,替换下面代码中的文件名,就能检查手里的 TTF 或 OTF。读 WOFF2 时,安装命令里的包名改为 "fonttools[woff]"。
from fontTools.ttLib import TTFont
with TTFont("font.ttf", lazy=True) as font:
names = font["name"]
print(names.getBestFamilyName(), names.getBestSubFamilyName())
print(names.getDebugName(4), names.getDebugName(6))
if "OS/2" in font:
print(font["OS/2"].usWeightClass, hex(font["OS/2"].fsType))
if "fvar" in font:
for axis in font["fvar"].axes:
print(axis.axisTag, axis.minValue, axis.defaultValue, axis.maxValue)
getBestFamilyName() 会从首选字体族等名称中取可用值,名称 ID 4 是完整字体名,6 是 PostScript 名。OS/2.usWeightClass 是文件登记的字重。fvar 表列出可变轴,存在 wght 轴时,才有这一轴上的连续字重。脚本也打印了 fsType,方便检查字库声明的文档嵌入限制。能否随软件发布、由网站提供或改成子集,仍以该版本的许可文本为准。
| Marker 用到的文件 | 文件内的 PostScript 名 | 文件登记的字重 | 项目如何使用 |
|---|---|---|---|
| 今楷 04 W03 | TsangerJinKai04-W03 |
静态 400 |
常规 400 |
| 今楷 04 W05 | TsangerJinKai04-W05 |
静态 400 |
粗体 700 |
| 思源黑体简中可变版 | SourceHanSansCNVF-ExtraLight |
默认 250,wght 轴 250–900 |
声明完整字重范围 |
今楷的两份文件都写了 400,但 W05 的字形本来就比 W03 粗。把 W05 在应用里声明为 700,浏览器就能在同一个家族下找到这份字形,原文件可以保持原样。项目可以给自己加载的字形声明独立的 CSS 家族名,字库内部的名称保持原样。这样也能和用户另装的同名字体区分。系统字体列表则使用操作系统给浏览器的家族名。
用同一个家族登记常规和粗体
Marker 随应用提供鸿蒙 Sans SC 的常规和粗体。下面这段声明保留了项目使用的家族名和字重,示例路径相对于样式文件。网页端如果使用上游提供的 WOFF2,可以把 URL 和格式替换为对应资源。Vite 的静态资源处理会重写 CSS 中的资源 URL。发布前从实际产物打开页面,确认路径能读到文件。
@font-face {
font-family: 'Marker HarmonyOS Sans';
src: url('./fonts/HarmonyOS_Sans_SC_Regular.ttf') format('truetype');
font-weight: 400;
font-display: swap;
}
@font-face {
font-family: 'Marker HarmonyOS Sans';
src: url('./fonts/HarmonyOS_Sans_SC_Bold.ttf') format('truetype');
font-weight: 700;
font-display: swap;
}
.article {
font-family: 'Marker HarmonyOS Sans', 'Microsoft YaHei', sans-serif;
font-weight: 400;
}
.article strong {
font-weight: 700;
}
文章普通段落用 400,加粗用 700,Marker 的部分标题会请求 680。在只有 400 和 700 的静态字体家族里,680 会匹配到现有的 700,500 会匹配到 400。如果换成思源黑体的可变版,应用用一条 @font-face 登记 font-weight: 250 900,浏览器可以直接取轴上的 680。需要精确到中间档时,先看具体文件的轴或静态字形,再决定要补哪一档。CSS Fonts 的匹配算法 · 可变字体的字形实测
这组样张取自 OpenHarmony 发布的鸿蒙 Sans SC 文件。第二行只登记常规文件,并允许浏览器按 font-synthesis-weight 合成粗体。第三行登记了独立粗体。

在这次 Chromium 对照里,后两行的计算字重都是 700。中间行实际绘制的 PostScript 名是 HarmonyOS_Sans_SC,最后一行才变成 HarmonyOS_Sans_SC_Bold。排查时在 Chrome DevTools 的 Elements → Computed → Rendered Fonts 查看具体一段文字。中文、拉丁字母和标点可能命中不同字体,分别检查出现差异的字符,就能缩小到字重匹配、粗体合成或缺字回退。
按需下载的单位是用户选中的家族
字体列表里选的是「仓耳今楷 04」,用户期望的是这篇文章能用这个家族阅读。项目里要准备两个文件,界面上只需要一个下载动作。正文和粗体各找自己的缓存,缺哪份取哪份。取消或失败时可以保留已经校验过的文件,等用户再次选择时补齐。
Marker 的今楷两档有各自的官网地址,可以并行取文件。方正官网要逐份确认许可,因此家族任务沿用同一个官网会话,把字形排队处理。筑紫明朝和筑紫 A 圆的常规、粗体在当前实现中走不同入口,下载地址和校验信息记在各自的文件项上。用户能看到正在处理常规还是粗体,传输返回字节总量并积累了速度样本后才显示预计时间。
桌面应用可以在隔离的 Electron 窗口打开官网,让用户阅读并确认许可。主进程从该会话的 will-download 事件接管下载,核对它来自指定字形的下载请求,再用 DownloadItem.setSavePath()写进临时文件。方正这条链路会重定向到带签名和期限的文件地址。下次要获取同一字形时,仍从厂商入口重新发起,当前签名地址只用于当前下载。验证下载时可以记录请求链和文件校验值,公开文档里保留产品页即可。
Marker 用字体表目录和文件边界排除明显无效或截断的文件。固定来源的文件还能用已记录的 SHA-256 核对文件是否一致。校验通过后,主进程把同目录的临时文件改名为缓存文件,其他窗口只会读到已写完的字库。渲染页等两档字形都能解析,再确认用户还在等待这次选择,然后应用字体。运行时注册节选弹窗
我在 Electron 中核对了启动时加载本机缓存的行为,也用龙马精神体粗体验证了扫码入口和取消后重试。两档在中途取消时的缓存行为由模拟官网下载的测试覆盖。真实官网扫码并逐档确认许可后的完整下载,还有待用真实账号验收。
先减掉用不到的文件,再考虑子集
中文字体的体积很容易超过这项功能本身。Marker 的鸿蒙 Sans SC 和寒蝉圆黑体各加一份粗体,两个原文件合计约 17.9 MB。随应用带上的好处是离线可用,代价是每个用户都会收到这些文件。可选字体按需获取之后,下载和缓存成本才由选中该家族的用户承担。
网页端可以优先取上游发布的 WOFF2,并按页面实际文字和首屏需求决定何时加载。像固定标题或菜单这种文字来源明确的场景,可以在许可覆盖修改的前提下生成子集。unicode-range 用来告诉浏览器哪份文件负责哪些码点,文件内真正收录哪些字,仍要由字库本身决定。这个博客把常用字放进体积较小的 WOFF2,其余码点交给完整字体按需处理。跨域提供网页字体时,还要检查字体响应是否允许页面所在的源访问。自由输入、用户文档和导出内容的字符范围更难预测,要留完整字库或可靠的系统回退。
字体选择器的预览也受同样的条件约束。我会用本机实际加载的家族预览用户能看到的效果。尚未取得字库时,预览可以显示下载入口或使用权利人许可的样张。把几个常用字裁成微型字库仍会交付一份字体文件,需要单独检查分发、修改和保留名称等条件。
总结
做一个项目的字体功能,我会先确定每个版本的文件从哪里到达用户设备,再确定这个家族需要几档字形。默认家族随应用提供时,文件、字重声明和许可一起进入发布产物。可选家族从远端获取时,常规和粗体跟着一次选择走,单个文件独立缓存,浏览器加载完成后才保存偏好。最后拿一段真实正文,核对常规、强调和缺字各自用了哪个文件。这样项目改包、换源或升级字库时,都能查到变化发生在哪一步。
在 Electron 渲染页注册已下载字形
这段示例保留了 Marker 的家族名、协议 URL 和字重映射。主进程通过 protocol.handle()只读取清单允许的字库。渲染页用 CSS Font Loading 的 FontFace 注册两个字重,等加载成功后再应用字体。
const family = 'Marker TsangerJinKai04';
const faces = [
new FontFace(family, 'url("marker-font://tsanger/TsangerJinKai04-W03.ttf")', { weight: '400' }),
new FontFace(family, 'url("marker-font://tsanger/TsangerJinKai04-W05.ttf")', { weight: '700' }),
];
for (const face of faces) {
document.fonts.add(face);
}
await Promise.all(faces.map(face => face.load()));
这里的协议 URL 由主进程实现,普通浏览器示例要替换成可访问的字体资源。每个渲染窗口有自己的 document.fonts,重启时从本机缓存清单重新登记字形,偏好只需要保存家族名。
字库厂商与设计师授权速查
资料核对于 2026 年 11 月 14 日。查到字体的发布者后,先看它采用的授权类型,再用上游发布页或随文件附带的许可确认版本。项目随包分发、网页加载字库、在用户本机调用已安装字体,以及导出带字库数据的 PDF,各有各的授权范围。
提供个人许可的字库厂商
用户可以按厂商的流程取得字库。要把同一份文件放进项目时,先看个人许可是否覆盖这一步,以及厂商有没有单独开放的版本。
仓耳字库
- 常规产品可从官网下载供个人非商业使用。授权范围见仓耳今楷产品页。
- 疫情期间开放的字库另按 2020 年开源声明处理。清单中的 6 套共 22 款可以嵌入、修改和再分发,分发须沿用原授权,字库不可单卖,见仓耳开源声明。
汉仪字库
注册后可以从官网下载个人版,安装在个人电脑并在本机调用。为个人研究、学习或欣赏,可按须知把字库复制到便携文件中并为同一目的展示。个人许可排除了项目分发字库、把字库加载进自己或第三方运营的产品等用途,见汉仪个人非商用须知第二条。
方正字库
- 家庭版可从方正或获授权渠道取得,在一台电脑上供个人非商用显示和打印。软件或网站要嵌入字库,须另获书面许可,整份字库、子集和转换格式都在条款范围内,见方正家庭版协议第 3、4 条。
- 免费商业发布覆盖客户端说明中列出的部分基础字库,例如方正黑体和方正书宋。免费范围排除了 App 嵌入和 Web Font,见方正客户端授权说明。
Aa 字库
有官网下载入口的字库可按官网流程获取,免费使用限于个人学习、研究或欣赏。工具内嵌和产品显示内嵌是单列的授权类型,见 Aa 字库授权说明。
华康字型
典藏个人版是付费的年度非商用方案,购买前要核对是否包含需要的字库版本。个人版协议第 7、14 条明确排除 App、游戏和嵌入式产品,厂商的授权表也把这些用途排除在所列标准方案之外,见典藏个人版 · 个人版协议 · 方案对照。
按作品许可或随附条款使用的字库
开源字体通常随发布包附许可。系统自带和应用内加载的字体,还要查发布者有没有授权项目自行提供字库文件。
Adobe 和 Google
思源黑体、思源宋体和 Noto CJK 采用 SIL OFL 1.1,可随软件分发或作为网页字体提供。分发时保留版权和许可,字库不可单卖。分发衍生版仍须使用 OFL,并按字库声明处理保留字体名称,见思源黑体 · 思源宋体 · Noto CJK · OFL 正文。
霞鹜(LXGW)
- OFL 作品可按上述条件随项目分发,例如霞鹜文楷,见霞鹜文楷项目。
- IPA Font License 1.0 用于霞鹜新晰黑、霞鹜新致宋。原版可随许可分发,衍生版另有同许可分发、提供换回原版的方法和命名等要求,见霞鹜新晰黑的许可 · 霞鹜新致宋的许可。
特里活字库(特里王)
官网将可免费嵌入的作品分为「免商可修改」和「免费商用」。字库文件能否单独分发或销售,还要查作品自己的声明,见活字库「字体授权」。
- 免商可修改包括汇文明朝体、汇文正楷。例如汇文明朝体允许修改、转发和随软件包销售,禁止单独转卖字库,见汇文明朝体声明。
- 免费商用包括京华老宋系列。作者允许把原版嵌入软件和复制传播,禁止修改字形或传播改版,也禁止单独出售字库牟利,见京华老宋体声明。
华为
OpenHarmony 随附的 HarmonyOS Sans SC 可以原样随一般软件交付,须在软件中显著说明并保留版权和许可。该许可禁止修改或单独再分发字库,见鸿蒙 Sans 字体许可。
微软
微软雅黑、Segoe UI、Consolas 的 Windows 随附版本可由应用调用,用来在用户设备上绘制内容。提取 Windows 字库随软件或网页分发通常需要单独授权,文档嵌入按对应字库的权限判断,见微软字体再分发说明。
微信读书
微信读书网页字体清单列有 AI 楷。目前未找到供第三方独立下载使用、嵌入或再分发的公开许可。