Sublime Text的font_face仅指向系统已注册字体名,不导出字体文件;备份需同步配置与目标机同名已安装字体,否则静默回退至Courier New。

Sublime Text 的 font_face 设置不能单独导出
Sublime Text 本身不保存字体文件,font_face 只是一个字符串字段,指向操作系统已注册的字体名。你改完 Preferences.sublime-settings 里的 "font_face": "LXGW WenKai",它不会把霞鹜文楷.ttf 一起打包带走——这个值只是“告诉 Sublime 去系统里找这个名字的字体”。所以不存在“导出字体设置”这回事,只有“导出配置 + 确保目标机装了同名字体”两步。
备份前必须确认字体已在系统注册且名称完全匹配
常见失败不是配置没备份,而是新设备上 fc-list(Linux)、字体册(macOS)或控制面板字体列表(Windows)根本查不到你写的那个 font_face 名字。大小写、空格、后缀(如 Source Han Sans CN 的 CN)错一个,Sublime 就静默 fallback 到 Courier New。
- Windows:右键字体文件 → “为所有用户安装”,然后在「设置→字体」里确认显示为
Microsoft YaHei(不是“微软雅黑”) - macOS:用「字体册」App 查看,右键字体 →「在字体册中显示」→ 复制顶部显示的**完整英文名**(如
PingFang SC),不是文件名PingFang.ttc - Linux:执行
fc-list : family | grep -i "wenkai",取输出中引号内的内容,再运行fc-cache -fv
Packages/User 备份后仍缺字体?重点检查 color_scheme 和主题依赖
很多人恢复后发现编辑区字体对了,但侧边栏、标签页、状态栏还是默认等宽字体——这不是 font_face 没生效,而是这些 UI 元素由当前主题(theme)控制,而主题文件(比如 Adaptive.sublime-theme)可能硬编码了字体,或引用了未同步的配色方案(.tmTheme 或 .sublime-color-scheme)。
-
color_scheme字段只存路径,如"Packages/Dracula Color Scheme/Dracula.tmTheme",对应文件得手动拷到新设备的Packages/Dracula Color Scheme/目录下 - 若用了 Nerd Font 补丁版(如
JetBrainsMono Nerd Font),需确保新设备也装了**同一补丁版本**,原版和补丁版注册名不同,混用会导致图标变方块 - macOS 上单字体声明易失效,建议在设置里写成字体链:
"font_face": "JetBrainsMono Nerd Font, DejaVu Sans Mono, monospace"
便携版用户别漏掉 Data/Packages/User 外的字体相关文件
便携版看似只用备份 Data/Packages/User,但如果你把字体文件(.ttf/.otf)直接扔进了 Data/Fonts/ 或 Data/Packages/ 下某插件目录,并在设置里写了相对路径(极少见但有人试过),那这部分就得一并迁移。不过这种做法不被官方支持,Sublime 不会从 Data/Fonts/ 自动加载字体——它依然只读系统字体库。所以最稳妥的方式始终是:在目标机系统级安装字体,再同步 Packages/User 里的配置。
真正容易被忽略的是:Sublime 启动时若检测到高 DPI 缩放或硬件加速异常,会绕过 font_face 直接降级渲染,此时加一行 "gl_hardware_acceleration": false 可快速验证是否为渲染层问题。











