需将.ttf或.otf字体文件复制到tofai安装目录下的fonts文件夹，重启软件并手动刷新字体缓存，再通过输入中英文验证渲染效果，否则需检查格式、路径或调整字体元数据。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您在使用tofai软件时希望为设计项目添加本地字体，但发现字体列表中缺少所需字型，则可能是由于字体未被正确导入至tofai的字体管理路径。以下是将自定义字体导入tofai的完整操作流程：
一、确认字体文件格式与完整性
tofai仅支持TrueType（.ttf）和OpenType（.otf）格式的字体文件，其他格式如.ttf.gz、.woff、.woff2或位图字体均无法识别。需确保下载的字体包已解压，且单个字体文件大小通常介于100 KB至5 MB之间，无损坏或不完整现象。
1、右键点击字体文件，选择“属性”，查看“常规”选项卡中的文件类型是否显示为“TrueType 字体”或“OpenType 字体”。
2、双击字体文件，在系统预览窗口中确认能正常显示字形及样式名称（如“Bold”“Italic”等），且无乱码或方块符号。
3、若字体以ZIP压缩包形式提供，使用解压工具完整解压至独立文件夹，避免嵌套多层子目录。
二、将字体文件复制到tofai指定字体目录
tofai不通过系统字体注册表读取字体，而是依赖其安装目录下的fonts子文件夹作为唯一字体加载源。必须将字体文件直接放入该路径，否则软件启动时不会扫描识别。
1、打开tofai安装根目录，典型路径为：C:\Program Files\tofai\fonts（Windows）或/Applications/tofai.app/Contents/Resources/fonts（macOS）。
2、确认fonts文件夹存在；若不存在，手动新建一个名为“fonts”的文件夹，注意拼写全小写、无空格。
3、将已验证有效的.ttf或.otf文件全部复制粘贴至该fonts文件夹内，不建议放入子文件夹，tofai不递归扫描下级目录。
三、重启tofai并刷新字体缓存
tofai在首次启动时会一次性扫描fonts目录并构建字体索引缓存，运行中新增字体不会自动生效，必须强制重启并触发重新加载机制。
1、完全退出tofai进程：在任务管理器（Windows）或活动监视器（macOS）中确认tofai相关进程已终止，包括“tofai Helper”“tofai Renderer”等后台组件。
2、重新启动tofai主程序，等待启动完成且界面完全渲染后，进入任意文本编辑面板。
3、点击字体下拉框右侧的刷新图标（两个环绕箭头），或按快捷键Ctrl+Shift+R（Windows）/Cmd+Shift+R（macOS）手动触发字体重载。
四、验证字体是否成功加载
导入结果需通过实际调用验证，仅出现在下拉列表中不代表可正常渲染，部分字体因元数据缺失可能显示名称但无法输出字形。
1、新建文本图层，点击字体选择框，向下滚动查找刚导入字体的完整名称（含空格与连字符，如“HarmonyOS Sans SC Bold”）。
2、选中该字体后，在输入框中键入中文“测试”与英文“Test”，观察是否出现清晰无锯齿、无替换提示（如方框或问号）的渲染效果。
3、若文字显示为默认字体（如PingFang或Microsoft YaHei），说明字体文件未被识别，需返回步骤二核查文件路径与格式。
五、处理常见字体加载异常
部分字体因版权嵌入策略或OpenType特性集冲突，会在tofai中触发静默失败，此时需调整字体元数据或启用兼容模式。
1、使用FontForge或Glyphs等专业字体编辑工具打开问题字体，检查“OS/2”表中的fsSelection位标志，确保bit 6（REGULAR）被启用，禁用“Reserved bit”类异常标记。
2、在tofai安装目录的config文件夹中，找到“font_config.json”，用文本编辑器打开，将字段“enable_font_substitution”值改为false，保存后重启软件。
3、对多字重字体（如“思源黑体”含7个字重），需确保每个.ttf/.otf文件单独存放且文件名不含版本号后缀（如删除“-Bold.ttf”中的“-Bold”，改用“SourceHanSansSC-Bold.ttf”标准命名）。
