sublime text 字体配置需严格使用系统注册名,如 windows 填 "microsoft yahei" 而非 "微软雅黑";font_face 和 font_size 必须写在 user 设置中,json 格式正确;连字需 sublime 4143+、匹配注册名及 "font_options": ["liga"] 三者齐备;ui 字体需修改主题文件或 st4.4277+ 的 ui_font_size。

字体名必须填系统注册的全名,不是显示名也不是文件名
Sublime Text 不安装字体,只调用系统已注册的字体。想用“微软雅黑”,得先在 Windows/macOS/Linux 上装好该字体,再在设置里填对它的内部注册名——比如 Windows 是 "Microsoft YaHei",不是 "微软雅黑";macOS 可能是 "PingFang SC" 或 "Heiti SC";Linux 下常用 "Noto Sans CJK SC" 或 "WenQuanYi Zen Hei"。填错一个字母、多一个空格、大小写不对,Sublime 就静默 fallback 到默认字体。
- 查系统注册名最可靠方式:Windows 用字体文件属性里的“字体名称”,macOS 用 Font Book 查“完整名称”,Linux 运行
fc-list :family筛选中文 - 中文字体必须搭配英文字体使用(如
"font_face": "Microsoft YaHei, Fira Code"),否则英文符号会糊或缺失 - 某些字体(如霞鹜文楷)注册名带空格或连字符,必须用引号包裹,且大小写严格匹配:
"LXGW WenKai"≠"lxgw wenkai"
font_size 和 font_face 必须写在 User 设置里,JSON 格式不能出错
打开 Preferences → Settings,只改右侧「User」面板。字段名拼错、少引号、多逗号,整份配置就失效,且不报错。
-
font_size是纯数字,单位 px,不是 pt 或 em;常用值 12–16;高分屏建议从 14 起试 -
font_face值必须是字符串,多个字体用英文逗号分隔:"font_face": "Microsoft YaHei, Fira Code" - 别写成
fontsize、font-size、FontFace—— Sublime 只认font_size和font_face - 保存后立即生效,无需重启;但若没变化,先检查 JSON 是否合法(可用在线 JSON 验证器)
连字(ligatures)要三要素同时满足,缺一不可
装了 Fira Code 或 JetBrains Mono 不代表连字自动开启。它需要 Sublime 版本、字体名、配置项三者对齐。
- 必须是 Sublime Text 4 Build 4143+(旧版即使配对也只渲染部分符号)
-
font_face必须和系统注册名完全一致:"Fira Code"和"FiraCode-Regular"在不同系统下可能互不兼容 - 加
"font_options": ["liga"],不是["ligatures"]或["enable_ligature"] - 连字启用后,
!=应显示为 ≠,=>应显示为 ⇒;若没变化,优先检查font_face是否匹配
编辑区之外的字体(侧边栏、标签页)要改主题文件,不是改 settings
font_size 和 font_face 只影响代码编辑区。菜单栏、侧边栏、标签页用的是主题定义的 UI 字体,必须手动改 .sublime-theme 文件。
- 路径在
Packages/Theme - [你的主题名]/[主题名].sublime-theme,或通过PackageResourceViewer提取第三方主题 - 搜索
"class": "sidebar_label"或"class": "tab_label",在里面加"font.face": "Segoe UI"和"font.size": 12 - 修改后需重启 Sublime 才生效;若用 Material Theme 等第三方主题,不提取覆盖则下次更新即丢失
-
ui_font_size在 ST4.4277+ 可统一控制 UI 字体大小,但不作用于控制台、命令面板等底层面板
真正麻烦的不是配字体,而是字体名和主题路径的隐式依赖——系统没装对、注册名抄错、主题文件找错位置,都会让设置看起来“没反应”。动手前先确认字体已注册,再逐层验证配置作用域,比反复重试更省时间。











