侧边栏字体模糊源于渲染路径错误：windows需设"font_options": ["directwrite"]并启用cleartype、高dpi设置；macos用["gray_antialias"]且font_size≥11.5；linux宜留空font_options。修改后须完全退出sublime才生效。
侧边栏字体模糊不是字体本身问题，而是 Sublime Text 没走对渲染路径——font_options 配错、系统级抗锯齿关着、DPI 缩放被绕过，三者占其一，字就糊。
Windows 高分屏必须设 font_options: ["directwrite"]
Sublime Text 4 Build 4126+ 默认用 GDI 渲染，对“微软雅黑”“思源黑体”这类中文字体的 hinting 和 subpixel 定位支持极差，小字号毛边、字重不均、边缘发虚都是典型表现。
-
font_options必须写成数组："font_options": ["directwrite"]（写成字符串或漏方括号会静默失效） - 系统 ClearType 必须启用并完成校准：控制面板 → 显示 → 调整 ClearType 文本 → 全程走完向导（只勾选不校准 = 没开）
- 右键 Sublime 快捷方式 → 属性 → 兼容性 → 更改高 DPI 设置 → 勾选「替代高 DPI 缩放行为」→ 下拉选「应用程序」
- 显卡驱动里若开了「覆盖应用程序抗锯齿设置」，临时关掉再测试
- 别混用：
["directwrite", "subpixel_antialias"]会冲突，只生效第一个
macOS Retina 屏只认 gray_antialias，禁用子像素
Retina 屏物理像素密度太高，子像素渲染不仅无效，还会让文字泛绿边、发虚、纤细无力——这不是字体问题，是渲染机制和硬件不匹配。
- 终端先执行：
defaults write -g AppleFontSmoothing -int 2（2 是中等平滑强度，0=关，3=最强） - 用户设置里只加：
"font_options": ["gray_antialias"]（别混subpixel_antialias） -
font_size小于 11.0 时，Core Text 会自动降级为无抗锯齿，建议设为11.5或12.0 - 改完必须完全退出 Sublime（菜单栏「Sublime Text → 退出」，不是关窗口），否则热重载不触发渲染管线重初始化
- 第三方主题（如 ayu、Material Theme）常在
.sublime-theme里硬编码font_options，搜一遍删掉或统一改成["gray_antialias"]
侧边栏字体大小不能靠 font_size 调整
font_size 只控制编辑区文字大小，侧边栏用的是 UI 主题定义的字体尺寸，改它完全没反应。强行调大会导致侧边栏挤成一团，图标错位。
- 真正起作用的是 UI 主题文件里的
font.size字段，路径一般是：Packages/Theme - Default/Default.sublime-theme - 打开该文件，搜索
"class": "sidebar_row"或"class": "sidebar_label"，找到对应 block 后添加或修改："font.size": 14 - 更稳妥的做法：换一个明确支持缩放的主题，比如
Adaptive.sublime-theme（自带ui_font_size配置项） - Windows/macOS/Linux 各自要注意：不同系统下同一配置效果可能差很多；macOS 还受
NSHighResolutionCapable影响，改 theme 后仍模糊，可试试在Info.plist里加NSRequiresAquaSystemAppearance设为false
Linux 下乱加 font_options 反而更糊
Linux 字体渲染高度依赖桌面环境（GNOME/KDE）、GTK 版本和 freetype 配置。font_options 不是开关，而是可能触发冲突的干预项。
- 多数现代发行版直接留空
font_options效果最好，让系统决定 - 若必须指定，用
["antialiased"]（注意不是"antialias"或字符串"antialiased"） - 别碰
subpixel_antialias：Wayland 会无视它，X11 下又容易和 fontconfig hinting 冲突 - 确保环境变量生效：
GDK_SCALE=2（配合桌面缩放 200%） - 检查
~/.config/fontconfig/fonts.conf是否启用抗锯齿：<edit name="antialias" mode="assign"><bool>true</bool></edit>
真正卡住的地方往往不是参数填多少，而是改完没完全退出就重启——热重载不触发字体渲染管线重初始化，所有配置等于白设。
