告别单调排版：SiYuan字体安装与管理全攻略
项目地址: https://gitcode.com/GitHub_Trending/si/siyuan 你是否还在为思源笔记中字体选择匮乏而烦恼？想让文档呈现独特风格却受制于默认字体？本文将带你从零开始掌握字体安装、管理与高级排版技巧，让知识创作更具个性与美感。读完本文，你将能够：
- 轻松安装任意TTF/OTF字体文件
- 掌握字体优先级与样式配置方法
- 解决常见字体显示异常问题
- 打造符合个人审美的文档排版系统
字体文件的秘密基地
思源笔记将所有字体资源集中存放在app/appearance/fonts/目录下，采用"字体家族-版本号"的文件夹命名规范。通过项目文件结构可以看到，官方已预置三款高品质字体：
- Noto-COLRv1-2.047：Google开发的多语言彩色字体
- JetBrainsMono-2.304：专为代码显示优化的等宽字体
- LxgwWenKai-Lite-1.501：清爽的开源中文字体
提示：所有字体文件夹均包含对应的LICENSE文件，使用第三方字体时请遵守开源协议。
三步安装自定义字体
1. 准备字体文件
确保你拥有合法的TTF(TrueType)或OTF(OpenType)格式字体文件。推荐从Google Fonts或Font Squirrel等正规平台下载。
2. 创建字体目录
在app/appearance/fonts/下新建文件夹，命名格式为"字体名称-版本号"，例如：
mkdir -p app/appearance/fonts/FiraCode-6.2
3. 放置字体文件
将字体文件复制到新建目录中，支持同时存放多个字重文件（如Regular、Bold、Italic等）：
app/appearance/fonts/FiraCode-6.2/
├── FiraCode-Regular.ttf
├── FiraCode-Bold.ttf
└── LICENSE
字体配置与应用
配置文件定位
思源通过localStorage中的LOCAL_FONTSTYLES键存储字体样式配置，对应源代码中的app/src/constants.ts定义：
public static readonly LOCAL_FONTSTYLES = "local-fontstyles";
应用字体到编辑器
- 打开思源笔记设置界面（快捷键
⌥P） - 导航至"外观设置"→"字体设置"
- 在"编辑器字体"下拉菜单中选择已安装的字体
- 调整字体大小和行高（推荐范围：14-18px）
- 点击"应用"使设置生效
注意：修改配置后可能需要重启应用才能完全生效。
常见问题解决
字体不显示怎么办？
- 检查文件格式：确保字体文件是TTF/OTF格式，避免使用WOFF等网页字体格式
- 验证文件完整性：尝试用系统字体查看器打开文件，确认字体可正常显示
- 检查目录权限：确保字体文件夹具有读取权限
- 清除缓存：通过"设置→高级→清除缓存"功能刷新资源
中英文混排不协调？
可通过自定义CSS代码片段解决，在Appearance→自定义样式中添加：
.protyle-wysiwyg {
font-family: "FiraCode", "LXGW WenKai", sans-serif;
}
这段代码指定等宽字体用于英文，文楷字体用于中文，系统会自动根据字符集选择合适的字体显示。
高级排版技巧
字体组合推荐
| 应用场景 | 字体组合方案 |
|---|---|
| 学术写作 | 思源宋体 + Latin Modern Math |
| 代码笔记 | JetBrains Mono + 思源黑体 |
| 文艺创作 | 方正清刻本悦宋简体 + Garamond |
响应式字体设置
通过媒体查询实现不同设备的字体适配：
@media (max-width: 768px) {
.protyle-wysiwyg {
font-size: 14px;
line-height: 1.6;
}
}
@media (min-width: 769px) {
.protyle-wysiwyg {
font-size: 16px;
line-height: 1.8;
}
}
扩展资源
通过掌握字体安装与管理技巧，你的思源笔记将展现出更加专业和个性化的排版效果。合理的字体选择不仅能提升阅读体验，更能激发创作灵感。开始你的字体探索之旅吧！
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
