根本原因是Sublime侧边栏字体由theme文件单独控制,需修改sidebar_label类并安装中文字体、配置输入法。Linux用户还需解决字体、IMESupport和硬件加速问题。

侧边栏中文显示方框,根本原因不是编码问题
这不是 UTF-8 没生效,也不是系统 locale 错了——Sublime 的侧边栏字体完全不走 "font_face" 和 "font_size" 这类全局设置,它由当前启用的 theme 文件(.sublime-theme)单独控制。哪怕你把编辑区中文调好了,侧边栏仍可能是一堆方框,因为它的文字渲染路径和编辑器主体是两套逻辑。
必须修改 theme 中的 sidebar_label 类
主题文件里真正管侧边栏文字的是 "class": "sidebar_label" 这个节点,不是 variables 里的 font_face,也不是 sidebar_tree 或 sidebar_container——后两者只影响布局和容器,不决定字形是否能 fallback 到中文字体。
- 打开
Preferences → Browse Packages…,进入User/目录 - 新建文件
sidebar-fix.sublime-theme(名字任意,后缀必须是.sublime-theme) - 写入最小有效配置:
[
{ "class": "sidebar_label", "font.face": "Noto Sans CJK SC", "font.size": 13, "line_height": 1.35 },
{ "class": "sidebar_container", "content_margin": [8, 4, 8, 4] }
] - 在
Settings – User中添加:"theme": "sidebar-fix.sublime-theme" - 必须彻底重启 Sublime(Cmd/Ctrl+R 不重载 theme)
Linux 下还要额外过三关
即使 theme 改对了,Linux 用户常卡在输入法坐标错位、字体未安装、或环境变量缺失这三步上,表现为:能打拼音但不出候选框、候选框固定在左上角、或者点开文件夹瞬间变方块。
- 确认已安装中文字体:
sudo apt install fonts-noto-cjk fonts-wqy-microhei - 确保输入法前端完整:
sudo apt install fcitx5-frontend-gtk3 fcitx5-frontend-qt5 - 用魔改版
IMESupport(非 Package Control 里那个),手动放进Packages/IMESupport/,并卸载旧版 - 在
Settings – User中加:"hardware_acceleration": "none",再右键快捷方式 → 兼容性 → 勾选“替代高 DPI 缩放行为”并选“应用程序”
dpi_scale 是双刃剑,慎用
网上流传的加 "dpi_scale": 1.0 确实能让方框消失,但它会强制缩放整个 UI,导致菜单栏、标签页、弹窗字体全部变小,且无法单独放大侧边栏——这是拿全局体验换局部可用,属于临时止痛,不是修复。
真正干净的做法是:让 theme 控制侧边栏字体,让系统字体配置支撑中文字形,让输入法插件同步光标位置。三者缺一不可;任何只动其中一项的方案,都会在高分屏、多显示器或滚动后突然失效。










