起初，我长期习惯于使用 4K 分辨率的显示器，可在我接触 Vibe Coding 以后，因为各种众所周知的缘故，我被迫拾起了家中那台饱经风霜的 Surface Go 3（屏幕分辨率为 1920 x 1200）作为远程桌面用机。可由于 Windows 设计糟糕的默认字体（同样字号，Chrome 中的思源黑体看上去十分优雅，而输入法中的微软雅黑却是古老的像素风格）与其渲染机制（短暂地试用过 MacType，其实效果不错，但其覆盖面太窄），我只好拿出 Codex 使用 GPT-5.5 做出了此脚本。
这是一套 Python 脚本，能把 Windows 系统界面字体换成你电脑上已经安装好的字体。
这个工具是离线的：不下载字体，不访问网络，不自带字体文件。你先在 Windows 里安装好想用的字体，然后用本工具把它生成成 Windows 系统 UI 会识别的 surrogate 字体，再写入相关注册表。
它会尽量覆盖这些地方：
- 传统 Win32 界面：文件资源管理器、旧式对话框、部分桌面程序。
- DirectWrite / WinUI：设置、开始菜单、任务栏、搜索、部分输入法界面。
- 中文 fallback：
Microsoft YaHei/Microsoft YaHei UI。 - 英文 UI：
Segoe UI/Segoe UI Variable。
它不会覆盖微软原始字体文件，例如：
segoeui.ttfSegUIVar.ttfmsyh.ttc
这是系统级字体修改，不是 Windows 官方提供的普通设置项。
使用前建议：
- 创建系统还原点。
- 保留本工具生成的
backups/文件夹。 - 第一次先选一个字形完整、字重完整的字体。要覆盖中文界面时，必须选择包含常见中文字形的字体。
- 修改后必须重启 Windows，再判断效果。
恢复方法见下面的「恢复到备份状态」。
你需要：
- Windows 10 或 Windows 11。
- 管理员权限。
- Python 3.9 或更新版本。
- Python 里已经安装
fontTools。 - 你想使用的字体已经安装到这台电脑。
检查 Python 和 fontTools：
python -c "import fontTools; print(fontTools.__version__)"如果这条命令报错，先安装 fontTools。本工具不负责联网安装依赖。
下载 ZIP，解压到一个普通文件夹，例如：
D:\Tools\Windows-System-Font-Modifier
在这个文件夹里打开 PowerShell。
如果你不知道怎么做：
- 打开解压后的文件夹。
- 在空白处按住
Shift，点右键。 - 选择「在终端中打开」或「在此处打开 PowerShell」。
powershell -ExecutionPolicy Bypass -File .\scripts\List-InstalledFonts.ps1如果你只想看可变字体：
powershell -ExecutionPolicy Bypass -File .\scripts\List-InstalledFonts.ps1 -VariableOnly输出示例：
VF Noto Sans SC wght
VF Sarasa UI ProDigits SC wght
-- Microsoft YaHei
左边是 VF 的字体表示它有 variable font。优先选这种。
比如你看到：
VF Sarasa UI ProDigits SC wght
那字体名就是：
Sarasa UI ProDigits SC
把下面命令里的字体名换成你自己的：
powershell -ExecutionPolicy Bypass -File .\scripts\Install-SystemFont.ps1 -SourceFamily "Sarasa UI ProDigits SC"系统会弹 UAC 管理员确认，点「是」。
如果你选的是大型中文 VF，第一次生成静态实例可能需要几分钟，属于正常现象。
如果工具提示源字体缺少常见 CJK 字形，说明它不适合作为 Microsoft YaHei / 微软雅黑 的替身。建议换成覆盖中文的字体。
如果你明确只想改英文界面，并且接受中文 fallback 可能显示异常，可以显式跳过这个保护：
powershell -ExecutionPolicy Bypass -File .\scripts\Install-SystemFont.ps1 -SourceFamily "Your Font" -AllowMissingCjk如果同一个字体同时安装了静态版和 VF 版，并且你希望普通系统字体保留静态版 hinting、只让 Segoe UI Variable 使用 VF，可以显式指定 VF 来源：
powershell -ExecutionPolicy Bypass -File .\scripts\Install-SystemFont.ps1 -SourceFamily "Sarasa Ui PropDigits SC" -SegoeVariableSourceFamily "Sarasa Ui VF PropDigits SC"这种模式下，普通 Segoe UI / Microsoft YaHei / Microsoft YaHei UI 仍从 -SourceFamily 生成静态 surrogate，Segoe UI Variable 以及对应的 FontSubstitutes 会指向 -SegoeVariableSourceFamily。
如果你要以 Windows 10 / UWP / WinUI 2 兼容为底线，可以显式使用静态兼容 profile：
powershell -ExecutionPolicy Bypass -File .\scripts\Install-SystemFont.ps1 -SourceFamily "Sarasa Ui PropDigits SC" -CompatibilityProfile Windows10-CompatibilityProfile Auto 是默认值。它会在系统存在 SegUIVar.ttf 时使用现代 profile；没有 SegUIVar.ttf 时自动退回 Windows 10 profile。Windows10 profile 不会生成或注册 Segoe UI Variable，只处理静态 Segoe UI / Microsoft YaHei / Microsoft YaHei UI 这些 Windows 10 和 UWP/WinUI 2 会用到的入口。
执行完会看到类似：
Windows system font mappings were updated.
Source family: Sarasa UI ProDigits SC
Backup: ...\backups\20260611-000000
Restart Windows before judging WinUI, taskbar, Settings, Start, and IME.
必须重启。只重启资源管理器通常不够。
重启后再看：
- 设置
- 任务栏
- 开始菜单
- 搜索
- 输入法
- 文件资源管理器
powershell -ExecutionPolicy Bypass -File .\scripts\Verify-SystemFont.ps1它会显示当前 Segoe UI、Segoe UI Variable、Microsoft YaHei 等注册表项指向了哪些生成字体。
恢复最近一次安装前的备份：
powershell -ExecutionPolicy Bypass -File .\scripts\Restore-SystemFont.ps1然后重启 Windows。
注意：恢复脚本会恢复到所选备份创建时的状态。第一次使用本工具前创建的备份通常就是 Windows 默认状态；如果你已经多次安装不同字体，最近备份对应的是“上一次配置”，不一定是微软默认配置。
如果你要指定某个备份目录：
powershell -ExecutionPolicy Bypass -File .\scripts\Restore-SystemFont.ps1 -BackupDir ".\backups\20260611-000000"Windows 日常界面对 VF 的支持并不均匀，所以本工具默认不把普通系统字体项直接指向 VF。
如果你选择的源字体本身有 VF，也就是 List-InstalledFonts.ps1 -VariableOnly 里能看到它，那么本工具会这样做：
Segoe UI Variable：保留生成后的真 VF。Segoe UI/Segoe UI Bold/Segoe UI Semibold/Segoe UI Light等普通项：从 VF 里提取对应静态实例。Microsoft YaHei/Microsoft YaHei UI：从 VF 里提取静态实例，再打包成 Windows 需要的.ttc。
也就是说：如果源字体只有 VF，普通 Segoe UI 会使用从 VF 提取出来的静态字体；只有 Segoe UI Variable 会继续使用真 VF。
普通 Segoe UI 相关项会按原 Windows 字重生成：
Regular 400
Semilight 350
Light 300
Semibold 600
Bold 700
Black 900
如果源 VF 的 wght 轴范围没有覆盖某个值，工具会使用源字体允许的最接近轮廓，但生成字体暴露给 Windows 的字重仍保持对应的 Segoe UI 字重。
如果通过 -SegoeVariableSourceFamily 指定了单独的 VF 来源，则普通系统字体项不会优先使用 VF，而是继续从静态来源选择最接近字重的静态 face；只有 Segoe UI Variable 保留 VF。
Windows 10 字体列表包含静态 Segoe UI 系列和 Microsoft YaHei UI，但没有 Segoe UI Variable。而 Windows 11 字体列表 才列出 Segoe UI Variable Display/Small/Text，它们来自 SegUIVar.ttf。
UWP / WinUI 的 XamlAutoFontFamily 是 XAML 控件默认字体；Microsoft 文档说明它会按 app language 选择字体：日文为 Yu Gothic UI，韩文为 Malgun Gothic，其他语言为 Segoe UI。因此简体中文场景下，Windows 10 兼容重点是静态 Segoe UI surrogate 本身要包含 CJK 字形，并且 Microsoft YaHei UI fallback 要能指向同一套生成字体。
-CompatibilityProfile Windows10 会跳过 Segoe UI Variable，避免在没有 SegUIVar.ttf 的系统上凭空创建现代入口。Modern profile 才会处理 Segoe UI Variable；Auto 会根据本机是否存在 SegUIVar.ttf 自动选择。
为了让静态字体包真正使用对应字重，构建器会把同一字体的静态 family 变体归并起来。例如选择 Sarasa Ui PropDigits SC 时，Sarasa Ui PropDigits SC Light、Normal、Medium、Heavy 也会参与匹配。实际选中的源 face 会写入 dist/manifest.json 的 source_faces 字段。
生成 surrogate 时，工具会读取 Windows 原始字体文件的垂直指标，并按新字体自己的 unitsPerEm 等比例写入生成字体。覆盖范围包括影响 UI 行高和基线的 OS/2 typo/win ascender、descender、lineGap，以及 hhea / vhea 的 ascent、descent、lineGap。
这些参考值优先来自 Windows 原始文件名，例如：
segoeui.ttfSegUIVar.ttfmsyh.ttcmsyhbd.ttcmsyhl.ttc
这样即使你已经安装过一次本工具、当前注册表指向 WSFM-*，再次生成时仍会对齐微软原始字体的 UI 指标。对齐结果会写入 dist/manifest.json 的 metrics_aligned / metrics_missing 字段。
如果源字体族里有真正的 Italic / Oblique，工具会优先使用它。
如果没有，工具会为这些项生成机械拉斜版本：
Segoe UI ItalicSegoe UI Bold ItalicSegoe UI Semibold ItalicSegoe UI Light ItalicSegoe UI Semilight ItalicSegoe UI Black Italic
这些是静态字体文件，名字和字重仍然按原 Segoe UI 项写入。
合成斜体主要针对 TrueType .ttf 轮廓做机械拉斜。少数 CFF/OTF 字体可能只能写入斜体元数据，不一定能真实改动轮廓。
注意：
- 原版
SegUIVar.ttf有wght和opsz轴。 - 很多开源中文 VF 只有
wght轴。 - 本工具不会伪造
opsz轴，因为没有真实轮廓变化的假轴对渲染没有帮助。
更多说明见 docs/VARIABLE_FONTS.md。
安装时会生成：
dist/fonts/WSFM-*.ttf
dist/fonts/WSFM-*.otf
dist/fonts/WSFM-*.ttc
dist/manifest.json
backups/<timestamp>/
其中：
dist/是生成字体和 manifest。backups/是恢复用备份，包含注册表导出、目标字体替换值快照，以及本次安装写入的生成文件清单。WSFM-开头的字体文件会复制到C:\Windows\Fonts。
这些生成文件不会提交到 Git。
本仓库代码使用 MIT License，见 LICENSE。
注意：
- MIT License 只覆盖本仓库的脚本和文档。
- 用户选择的源字体仍然受它自己的字体许可证约束。
- 本工具生成的 surrogate 字体不建议公开分发，除非你确认源字体许可证和命名/商标要求允许这么做。