Cascadia Code 必须系统级安装并用操作系统注册的全名配置,Windows查字体设置、macOS用字体册、Linux用fc-list确认;font_face严格匹配注册名,需加"ligatures"启用连字,PL版本才支持PowerLine符号。

Sublime Text 本身不安装字体,Cascadia Code 必须先完成系统级安装、注册,并在设置中用操作系统识别的**真实全名**准确配置,否则静默 fallback 到 Consolas 或 Courier New。
怎么确认系统已正确安装 Cascadia Code
装完字体文件(如 CascadiaCodePL.ttf)后,Sublime 不会自动发现它——你得先验证系统是否真正“认”了这个字体:
- Windows:打开「设置 → 蓝牙和其他设备 → 字体」,搜索
Cascadia,点开详情看「字体名称」字段,常见注册名为Cascadia Code PL(注意空格和大小写),不是文件名也不是 GitHub 页面显示名 - macOS:双击字体安装后,打开「字体册」App,筛选「电脑」范围,选中字体 → 右下角「信息」面板里的「完整名称」才是你要抄的,比如
Cascadia Code PL或CascadiaMonoPL - Linux:终端运行
fc-list : family | grep -i cascadia,输出中带引号的那串(如"Cascadia Code PL")才是有效 family name;若无输出,说明缓存未刷新,补上fc-cache -fv
font_face 怎么写才生效(大小写/空格/连字符全敏感)
Sublime 的 font_face 字段严格匹配系统注册名,填错一个字符就失效。常见错误包括写成 "Cascadia Code"(系统里实际是 Cascadia Code PL)、"cascadia-code-pl"(小写+连字符)、或漏掉 PL 后缀导致 PowerLine 符号不显示:
- 只用英文编程:直接填
"font_face": "Cascadia Code PL" - 需中英混排(推荐):
"font_face": ["Cascadia Code PL", "Microsoft YaHei", "SimSun"]—— 英文、符号走连字,中文 fallback 到雅黑,再不行用宋体兜底 - Linux/macOS 用户特别注意:如果
fc-list或字体册里显示的是CascadiaCodePL(无空格),那就必须写成"CascadiaCodePL",不能硬加空格 - JSON 格式要合法:字符串用双引号,冒号后留空格,末尾不能多逗号
为什么启用了还是看不到连字或 PowerLine 符号
启用 Cascadia Code PL 后仍显示 => 而非 ⇒,或 类图标变方块,通常不是字体问题,而是配置或渲染链断裂:
- 没启用连字支持:Sublime 默认关闭连字,必须手动加
"font_options": ["ligatures"](ST4 支持,ST3 不支持) - PowerLine 符号缺失:确保装的是
CascadiaCodePL.ttf或CascadiaMonoPL.ttf,而非标准版;且终端/插件(如 PowerLine status bar)本身也需启用对应 glyph 渲染 - 高 DPI 下发虚或方块:临时加
"gl_hardware_acceleration": false缓解;Windows 用户可额外加"font_options": ["subpixel_antialias"] - 改完设置后没彻底重启:macOS 需用 Activity Monitor 杀掉所有
subl进程;Windows 查任务栏托盘,右键退出 Sublime 再重开
最容易被忽略的是:系统字体注册名和 font_face 值之间存在「不可见差异」——比如 macOS 字体册里显示 Cascadia Code PL,但复制时带了零宽空格,粘贴进 Sublime 设置后看着一样,实际校验失败。建议直接从系统字体工具里复制,别手打。











