必须彻底退出sublime text再重开才能生效;仅关闭窗口不退出进程会导致新字体设置不加载,windows需结束所有subl.exe,macos需在activity monitor中强制退出,linux需执行pkill -f "subl"。

Sublime Text 里改完 font_face 必须彻底退出再重开
改完用户设置里的 font_face 或 font_size,保存后不会实时刷新 UI 字体——命令面板、侧边栏、标签页这些地方的字体要等完全重启才生效。只关窗口不退出进程(比如 Windows 托盘还在、macOS 进程没杀)会导致新设置不加载。
- Windows:任务栏右键 Sublime 图标 → “退出”,或任务管理器结束所有
subl.exe进程 - macOS:Activity Monitor 搜索
subl或Sublime Text,强制退出;别只关窗口 - Linux:终端执行
pkill -f "subl"或killall subl
系统字体装好后,Sublime 不会自动感知,必须手动验证名称
双击安装 .ttf 文件 ≠ Sublime 能用。它只读操作系统注册的「全名」,且大小写、空格、连字符全部敏感。填错就静默 fallback 到 Consolas 或 Courier New。
- Windows:打开「设置 → 蓝牙和其他设备 → 字体」,搜索“Microsoft YaHei”,点开看「完整名称」字段
- macOS:双击字体文件 → 「显示简介」→ 查「全名」,不是「版权」或「样式」
- Linux:终端运行
fc-list : family | grep -i "yahei",输出带引号那行才是真实名,如"Microsoft YaHei" - 填进 Sublime 设置时,必须和系统显示的全名**逐字符一致**,比如
"Source Han Sans CN"不能少空格、不能写成"SourceHanSansCN"
Linux/macOS 装完字体不生效?大概率漏了缓存刷新
Linux 和 macOS 安装字体后,字体服务不会自动重载缓存,Sublime 启动时读的是旧缓存,导致 fc-list 都查不到,更别说用了。
- Linux:复制字体到
~/.fonts/或/usr/local/share/fonts/后,必须运行fc-cache -fv(-v看输出,-f强制重建) - macOS:装完后打开「字体册」App,顶部菜单选「文件 → 验证字体」,再确认目标字体状态为「已启用」且范围是「电脑」
- 验证方式:重启 Sublime 前,先在终端跑
fc-list | grep -i "your-font-name",有输出才算真正就位
侧边栏、标签页字体不随 font_face 变?那是主题文件控制的
用户设置里的 font_face 只影响编辑区文字,UI 元素(侧边栏、标签页、状态栏)由当前启用的 .sublime-theme 控制,改设置无效。
- 先查你用的是哪个主题:用户设置里看
"theme"值,比如"Material-Theme.sublime-theme" - 进
Preferences → Browse Packages → User/,新建同名文件(如Material-Theme.sublime-theme) - 在里面加类似这样的块:
{ "class": "sidebar_label", "font.face": "Microsoft YaHei", "font.size": 12 }注意字段名是font.face(带点),不是font_face - 改完必须彻底退出 Sublime 再重开,UI 字体才会更新











