悠哉字体报错自救实录：装完找不到、方块字、字重失踪，三招定位根源
【免费下载链接】yozai-fontA Chinese handwriting font derived from YozFont. 一款衍生于 YozFont 的中文手写字型。项目地址: https://gitcode.com/gh_mirrors/yo/yozai-font
悠哉字体（Yozai Font）是一款衍生于 YozFont 的开源中文手写字体，免费可商用，GB2312 的 6763 个汉字一个不少。可就是这么贴心的字体，第一次装完就给我来了个下马威——在 Word 里翻遍字体列表，愣是找不到"悠哉"两个字。好不容易装上了，又接连撞上"方块字"和"字重失踪"。这篇文章就按我踩坑的顺序把路给你排好，跟着跳过去，十分钟内跑通。
第一关 装完找不到"悠哉"：不是字体坏了，是安装姿势不对
现象：双击字体文件点了"安装"，软件也重启了，字体列表里依然没有；或者列表里有"悠哉"，但选中的中文还是宋体。
原因一句话讲透：字体文件分成多个字重，你只装了一个；或者系统字体缓存没刷新，软件压根没发现新字体。
解法分三步：
- Windows 上别只双击安装，右键字体文件，选"为所有用户安装"；
- 装完彻底退出并重开 Word、PS 这类软件，它们只在启动时扫描字体；
- Linux 下刷新一下字体缓存就行：
# 刷新系统字体缓存，让新装字体立即生效 fc-cache -f还不行，就用fc-list | grep -i yozai查一下系统到底认没认到字体。认不到，多半是压缩包里的字体文件没解压全。
第二关 打出中文全是"□□□"：先分清是缺字、旧版还是字形差异
现象：正常句子显示没问题，可一到某些字就变成方框；或者通篇看着"怪怪的"。
原因有三层，按顺序查：
- 版本太老。早期版本的悠哉字库并不全，生僻字缺字很正常。去 Releases 下最新版——现在已覆盖《通用规范汉字表》全部 8105 字，CJK 基本区 20992 字也由深度学习补全了，覆盖范围见下图：
装错字重文件。常见乌龙：只装了某个字重的文件，恰好缺你要的那个。检查 Light、Regular、Medium 是否都装全了（Bold 的下落见第三关）。
不是坏字，是字形差异。悠哉源自日系手写体 Y.OzFont，作者虽对大部分常用字做了"简中化改造"，仍有一部分字保留日本写法，看着像"写错了"。这是已知情况而非报错，对比见下图：
真遇到缺字或拼接生硬的情况，去 Issues 反馈即可，作者会逐个修。
第三关 字重集体失踪：Bold 被取消，旧版还赖着不走
现象：以前能用的 Bold 字重不见了，列表里只剩几个细字重。
原因一句话讲透：从 0.860 版本起，悠哉正式取消 Bold 字重，只保留 Light、Regular、Medium 三个，作者认为 Bold 交给系统渲染即可。
解法：
- 想要强调效果，用 Medium 代替 Bold，视觉上够用；
- 非要 Bold，只能退回 0.859 及以前的版本。
这里还有个配套的坑 🚩：0.723 版本曾把字体英文名统一改成 Yozai，旧版字体残留在系统里会和新版同名冲突，导致新装的不生效。所以升级前，务必先把旧版删除再装新版。
三分钟快速自查清单：跑通前的最后一遍检查
按顺序过一遍，90% 的问题都能当场定位：
- 用的是不是最新版？早期版本字库不全，优先更新
- 三个字重文件是否全部安装？只装一个容易"缺字"
- 安装后重启软件了吗？Word、PS 只在启动时扫描字体
- 字体缓存刷新了吗？Linux 执行
fc-cache -f - 是不是在找 Bold？0.860 起已取消，用 Medium 替代
- 升级前删掉旧版了吗？0.723 改过字体名，残留会冲突
- 显示"怪字形"是不是日系写法？可能是已知差异而非 bug
延伸资源：从哪继续深挖
- 更新日志：History.md，每个版本改了什么字、加了什么字都有记录
- 完整预览：documentation/，下载前先看整体效果
- 授权协议：OFL.txt，免费商用、可自由修改，但禁止单独出售字体文件——淘宝上倒卖这款字体的商家都是侵权，别买
想自己动手，直接克隆仓库体验：
git clone https://gitcode.com/gh_mirrors/yo/yozai-font现在就去下载最新版，把这几个坑一次性跳过去，跑通你的第一个手写字体文档吧。
【免费下载链接】yozai-fontA Chinese handwriting font derived from YozFont. 一款衍生于 YozFont 的中文手写字型。项目地址: https://gitcode.com/gh_mirrors/yo/yozai-font
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考