Sublime Text字体配置需系统级安装Cascadia Code PL并严格匹配系统注册名,编辑区与UI元素(如侧边栏)须分别配置,连字功能还需满足字体版本、font_options和正确字体文件三条件。

字体文件必须系统级安装,不能只丢进Sublime目录
Sublime Text不自带字体,只调用操作系统注册的字体。把CascadiaCodePL.ttf复制到项目文件夹或Packages/目录下完全无效——编辑器根本看不到它。
在macOS上,双击每个CascadiaCode*.ttf文件,在字体册中点击“安装字体”,并确认状态为“已安装”且归属“电脑”(不是“用户”);Windows需右键选择“为所有用户安装”;Linux则复制到/usr/local/share/fonts/后运行fc-cache -fv。
- 装完立刻打开字体册搜索“Cascadia Code”,看是否显示全名是
Cascadia Code PL或Cascadia Code(注意大小写、空格、PL后缀) - 别信文件名:比如
CascadiaCodePL-Regular.ttf≠ 系统注册名,后者可能是Cascadia Code PL - 如果搜不到,说明没装成功,重来;搜到了但Sublime仍不认,大概率是
font_face填错了
settings.json里font_face必须严格匹配系统全名
Sublime对字体名大小写、空格、连字符全部敏感。填"font_face": "CascadiaCodePL"或"Cascadia Code"(少个PL)都会静默 fallback 到默认字体,且不报错。
正确写法示例(macOS):"font_face": "Cascadia Code PL"
Windows常见写法:"font_face": "Cascadia Code PL" 或 "font_face": "CascadiaCodePL"(取决于系统注册名)
- 务必去系统字体册/字体设置里查“全名(Full Name)”,原样复制粘贴
- 中英文混排必须加fallback:例如
"font_face": "Cascadia Code PL, PingFang SC, Microsoft YaHei" - JSON语法要合法:字段名是
font_face,不是font-face或fontFace;末尾不能多逗号
连字支持需同时满足三条件,缺一不可
输入!=或=>没合并?不是配置漏了,是底层链断了。Cascadia Code PL本身含连字表,但Sublime必须三重条件齐备:
- 字体文件得是带PL后缀的完整版(非普通
Cascadia Code) - 配置里必须同时有:
"font_face": "Cascadia Code PL"和"font_options": ["liga"] - Sublime版本 ≥ 4.4143(Build 4143+),旧版连字渲染不稳定甚至部分符号失效
验证方式:直接在编辑区敲&&、||、=>,别依赖插件提示;若无效,优先重装字体而非反复改配置。
侧边栏、标签页字体根本不读font_face
你改了font_face,代码区变了,但左侧文件树还是小得费眼?这不是配置失效,是Sublime压根没让侧边栏走这个字段。它用的是UI主题渲染路径,和编辑区完全隔离。
要改侧边栏字体,必须修改当前启用的.sublime-theme文件:
用PackageResourceViewer插件打开主题资源,搜索"class": "sidebar_label",在其rule里加:"font.face": "Cascadia Code PL" 和 "font.size": 13
- 改完必须完全退出Sublime(macOS要从菜单栏选「退出」,不是关窗口),否则缓存不刷新
- ST4.4277+支持
ui_font_size全局缩放,旧版只能硬改主题 - 别指望一个
font_face值通吃所有界面元素——编辑区、侧边栏、状态栏、标签页,各走各的路



















