侧边栏中文显示方块是因sublime未通过theme文件为sidebar_label类指定中文字体,需手动创建.sublime-theme文件配置font.face并重启软件。

侧边栏中文显示方块,不是编码问题
Sublime 的侧边栏(sidebar)文字渲染和编辑区完全隔离,改 default_encoding 或 fallback_encoding 对它没用。你看到的“□”或空白,是字体缺失或 theme 配置未命中 sidebar_label 类,跟文件编码、BOM、UTF-8 设置全无关系。
必须手动写 .sublime-theme 文件配字体
侧边栏只认 theme 文件里明确声明的 class,核心是 "class": "sidebar_label" 这一项。全局 font_face 设置对它无效。
操作步骤:
- 菜单 Preferences → Browse Packages…,进入
User/目录 - 新建文件
sidebar-fix.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]
}]
然后在 Preferences → Settings – User 中加一行:"theme": "sidebar-fix.sublime-theme"。改完必须彻底重启 Sublime(Cmd/Ctrl+Q 再打开),Cmd/Ctrl+R 不重载 theme。
Linux 用户额外三步绕不开
即使 theme 写对了,Linux 下还常卡在:
- 没装中文字体:运行
sudo apt install fonts-noto-cjk(Ubuntu/Debian)或等效命令 - 输入法前端不完整:需装
fcitx5-frontend-gtk3和fcitx5-frontend-qt5 - IMESupport 插件失效:Package Control 里的旧版不管用,得手动下载魔改版放进
Packages/IMESupport/并卸载原版
另外,别碰 dpi_scale。网上说设成 1.0 能“解决方块”,实际是把整个 UI 缩小,侧边栏字变小了,但菜单栏、标签页也一起缩水——这不是修复,是降级妥协。
macOS / Windows 用户重点查字体名
macOS 可直接用 "font.face": "PingFang SC" 或 "Helvetica Neue";Windows 常见可用的是 "Microsoft Yahei"、"SimHei"、"Noto Sans CJK SC"。别写错大小写或空格,Sublime 不报错也不 fallback,就静默显示方块。
验证是否生效:重启后打开一个含中文路径的文件夹,看侧边栏文件名是否正常。如果仍乱,检查系统是否真有那个字体(macOS 字体册、Windows 字体文件夹),而不是只靠名字猜。











