sublime text字体发虚、中英文粗细不均的根源是font_face未填系统注册名、font_options未配subpixel_antialias,且linux需fc-cache -fv刷新字体缓存;windows安装必须勾选add to path、add to explorer context menu、create desktop shortcut三项,否则命令与右键功能失效。

Sublime Text 装完默认字体发虚、中文粗细不均、英文字符偏细——这不是你显示器的问题,而是默认没启用字重控制,且系统字体注册名和 Sublime 实际识别名不一致导致的。
安装时必须勾的三项,漏一项后续字体就卡住
Windows 安装包运行后,在 “Select Components” 页面,这三项不勾,subl 命令打不开、右键菜单没有“Open with Sublime Text”、中文插件装了也无效:
-
Add to explorer context menu:否则双击 .py/.js 文件不会用 Sublime 打开 -
Add to PATH:终端输subl报 command not found 就是它没勾 -
Create a desktop shortcut:新手找不到图标,本质是启动入口缺失
Linux 用户走 APT 安装(sudo apt install sublime-text)自动解决 PATH 和桌面图标;但手动解压 tar 包的,必须自己加软链接:sudo ln -s /opt/sublime_text/sublime_text /usr/bin/subl,否则连 subl 都不可用,更别说调字体。
font_face 填错名字,字体就白装
font_face 不是字体文件名(如 FiraCode-Regular.ttf),也不是显示名(如 “Fira Code Medium”),而是系统注册的**内部字体全名**,大小写敏感,空格不能少也不能多。
- Windows 查真实名:打开字体文件 → 右键“属性” → “详细信息”标签页 → 看“字体名称”字段(例如
Fira Code Retina,不是Fira Code) - macOS 终端运行:
fc-list :family | grep -i "fira",输出类似FiraCode-Retina或Fira Code - Linux 运行:
fc-list | grep -i "jetbrains\|fira",注意返回的是冒号分隔的完整路径+名字,取冒号前那段(如JetBrains Mono)
填错就回退到默认的 Consolas/DejaVu Sans Mono,看着像“没生效”,其实是根本没匹配上。常见坑:"Fira Code" 在 Windows 上常要改成 "FiraCode-Retina" 或 "FiraCode-Regular" 才能出字重。
font_options 控制字重,liga 不等于 bold
Sublime 没有 font_weight 字段,字重靠 font_options 里的渲染指令间接影响。真正起作用的不是“加粗”,而是抗锯齿模式和连字开关组合:
-
["subpixel_antialias"]:Windows/macOS 高分屏下让文字边缘锐利,中文字体变实、英文变挺 -
["no_round_gridfit"]:禁用栅格化对齐,避免小字号下笔画粘连或断笔(尤其对“微软雅黑”类字体有效) -
["liga", "dlig"]:只对支持连字的字体(如 Fira Code)生效,和字重无关;误加反而可能让某些符号渲染异常
典型安全配置(兼顾中英清晰度):
{
"font_face": "FiraCode-Retina",
"font_size": 13,
"font_options": ["subpixel_antialias"]
}
别写 ["bold"] 或 ["weight=700"]——Sublime 不认这些值,写了等于没写,还可能干扰其他选项。
Linux 下 fc-cache 不刷新,font_face 永远不生效
装完新字体(比如从 GitHub 下载 JetBrains Mono 并复制进 /usr/share/fonts/),Sublime 读不到,不是配置问题,是字体缓存没更新。
- 运行
sudo fc-cache -fv强制重建全部缓存(-v显示过程,-f强制覆盖) - 检查是否成功:
fc-list | grep -i "jetbrains"应该立刻输出带路径的结果 - 重启 Sublime Text(仅 reload settings 不够,必须完全重启进程)
Ubuntu/Debian 用户容易忽略这点,装完字体以为万事大吉,结果 font_face 死活不匹配——缓存没刷,系统层面就“看不见”那个字体。
字重优化的关键不在“加粗”,而在选对注册名 + 开对抗锯齿 + 刷对缓存。改完设置不用重启编辑器,但 Linux 下换字体后必须 fc-cache -fv 再重启 Sublime,否则所有配置都是空中楼阁。











