Sublime Text换字体需满足三点：字体名须与系统注册名完全一致；编辑区与侧边栏字体必须分开配置（侧边栏需修改.sublime-theme文件）；中英文混排须用字符串数组fallback（如["Fira Code","PingFang SC"]），单字体易导致乱码或回退默认字体。
Sublime Text 换编程字体不是改个名字就完事，关键在三点：字体名必须和系统注册名完全一致、编辑区和侧边栏字体要分开配、中英文混排必须用 fallback 列表而非单字体——填错一个字符或漏掉一个配置项，都会静默回退到默认字体，且不报错。
怎么确认系统里有没有装对字体
Sublime 不自带字体，只调用系统字体册里的名称。你写 "font_face": "Fira Code"，但系统里实际注册的是 "FiraCode-Retina" 或 "Fira Code Regular"，它就找不到。
- Windows：右键字体文件 → “为所有用户安装”，然后在 PowerShell 里运行
Get-Font -Name "Fira*"（需先装模块）或打开“字体设置”搜索全名 - macOS：双击安装后，打开“字体册”App，搜索并点开字体详情，看“全名”字段（注意空格、连字符、“Regular”后缀是否包含）
- Linux：把 .ttf 复制到
~/.fonts/后必须运行fc-cache -fv，再用fc-list | grep -i "fira"验证是否识别
编辑区字体怎么设才生效
编辑区字体由 font_face + font_size 控制，但参数写法有硬约束：
-
font_face必须是字符串或字符串数组；单字体写法如"Fira Code"，中英混排推荐数组写法如["Fira Code", "PingFang SC", "Microsoft YaHei"]（等宽优先，中文 fallback） -
font_size建议 ≥11.0（macOS 下低于 11.0 会自动关闭抗锯齿），小数如12.5是合法的 - 连字（ligatures）需同时满足：字体本身含连字表（Fira Code ≥ v6.2）、
font_options包含"liga"、且系统未禁用 OpenType 特性（Windows 上别混用"directwrite"和"liga"，后者在 DirectWrite 下不一定生效）
侧边栏字体为什么死活不变
侧边栏（Sidebar）根本不读 font_face 字段，它走 UI 主题渲染路径，和编辑区完全隔离。
- 必须手动修改当前启用的
.sublime-theme文件，在对应sidebar_label或sidebar_heading的 class 里加"font.face": "SF Mono"和"font.size": 13 - 主题文件位置可通过命令面板输入
UI: Select Theme查看当前值（带 ✔️ 的那行），比如Material-Theme-Darker.sublime-theme，路径就在Packages/Material Theme/下 - 直接在用户设置里加
sidebar_font_size或类似字段，Sublime 会默默忽略——不报错、不警告、也不生效
字体发虚模糊的真正原因和解法
模糊不是字体差，是渲染策略和系统能力没对齐。不同平台关键配置不能混用：
- Windows 高分屏：必须设
"font_options": ["directwrite"]，且系统 ClearType 已启用、快捷方式兼容性里勾选「替代高 DPI 缩放行为」→「应用程序」；禁用显卡驱动的抗锯齿覆盖 - macOS Retina 屏：删掉所有
no_antialias或subpixel_antialias，终端执行defaults write -g AppleFontSmoothing -int 2，用户设置只加"font_options": ["gray_antialias"] - Linux：多数情况下留空
font_options效果最好；若必须指定，用["antialiased"]，同时确保GDK_SCALE=2环境变量生效、hardware_acceleration设为"none"避免绕过 GTK 渲染
改完必须完全退出 Sublime（macOS 注意菜单栏「退出」，不是关窗口），否则缓存不刷新，所有配置都白调。
