如何在CheatReader中加载本地自定义字体:ttf/otf 字体切换完整教程
如何在CheatReader中加载本地自定义字体:ttf/otf 字体切换完整教程
CheatReader 是一款轻量级的悬浮桌面阅读器,支持 txt、epub、pdf 等多种本地文件格式,并提供本地自定义字体加载功能。你可以在阅读设置中直接选择电脑上的 ttf / otf 字体文件,一键替换阅读字体,且设置自动保存,重启后依然生效。
一、CheatReader 字体系统:4 种可选字体
CheatReader 的字体切换入口位于阅读设置面板的"字体"分组中,提供 4 个分段选项(见 lib/l10n/app_zh.arb):
| 选项 | 说明 |
|---|---|
| 默认 | 系统默认字体,无任何回退 |
| 衬线 | 宋体 / Times 风格,适合长文 |
| 等宽 | Menlo / Consolas 风格,适合代码 |
| 自定义 | 加载你本地的 ttf / otf 字体文件 |
点击"自定义"后会直接弹出系统字体选择器,只允许选择 ttf 和 otf 两种扩展名,对应源码见 lib/src/reader_app.dart#L49-L56。
二、加载 ttf/otf 字体的完整步骤
步骤 1:打开阅读设置
在 CheatReader 窗口中通过菜单或快捷键打开"阅读设置"(Reading Settings)面板。
步骤 2:点击"字体 → 自定义"
在"字体"分组中点击自定义,系统会弹出文件选择器(选择器逻辑见 lib/src/reader_app.dart#L1547-L1567):
- 如果你还没有加载过字体,行为是"选择字体"
- 如果你已经加载过字体,行为是"替换字体"
步骤 3:选择本地字体文件
在弹出的文件选择器中浏览到你的字体文件(如 NotoSerifSC-Regular.ttf),确认后应用会:
- 读取字体文件字节并校验非空
- 通过
FontLoader注册一个唯一的字体家族名(格式为CheatReaderCustomFont_<hash>) - 立即把阅读窗口切换到该字体
整个加载过程由 lib/src/reader_custom_font.dart 完成,字体家族名由路径的稳定哈希生成,因此不同字体文件互不冲突,且同一文件不会重复加载。
三、字体切换与持久化:重启后自动恢复
- 切换预设字体很简单:在"字体"分组中点击"默认 / 衬线 / 等宽"即可切回,自定义字体文件仍会保留在设置中,随时可以切回来
- 自定义字体的路径与文件名会写入本地偏好存储,键名见 lib/src/reader_preferences.dart#L47-L49(
reader.customFontPath、reader.customFontDisplayName等) - 应用启动时会自动检查并重新加载已保存的字体,逻辑见 lib/main.dart#L27-L28,所以你不需要每次启动都重新选择字体
底层设置写入由 ReaderController 的 setCustomFont 方法负责,可参考 lib/src/reader_controller.dart#L305-L313;清除自定义字体并回退到系统默认字体则对应 clearCustomFont(lib/src/reader_controller.dart#L315-L326)。
四、常见问题排查
| 现象 | 原因与解决 |
|---|---|
| 提示"无法打开字体选择器" | 系统文件选择器被拦截,检查系统权限设置后重试(提示文案见 lib/l10n/app_zh.arb) |
| 提示"无法加载这个字体文件" | 文件损坏、为空或不是合法的 ttf/otf,换一个字体文件试试 |
| 切换后字体没变化 | 确认当前"字体"分组选中项为"自定义",且该字体文件已被成功加载 |
💡 小建议:中文长文阅读推荐选择带完整中文字形的 otf 字体(如思源宋体、霞鹜系列),在透明文字模式下显示效果更佳。
五、相关源码与资料索引
| 文件 | 作用 |
|---|---|
| lib/src/reader_custom_font.dart | 自定义字体加载与家族名哈希 |
| lib/src/reader_controller.dart | setCustomFont / clearCustomFont 设置读写 |
| lib/src/reader_app.dart | 字体选择器调用与阅读界面字体渲染 |
| lib/src/reader_preferences.dart | 字体设置的持久化存储 |
| lib/l10n/app_zh.arb | 中文界面文案(含字体相关提示) |
| README.zh-CN.md | 项目功能总览与平台支持说明 |
结语
CheatReader 的自定义字体功能把"选文件 → 立即生效 → 自动记忆"压缩成了一次点击:无论是 ttf 还是 otf,都能在几秒内换上自己最喜欢的阅读字体,配合透明文字模式和悬浮窗口,让桌面阅读体验更加私人化。
