侧边栏中文显示方块，不是编码问题
很多朋友一看到Sublime侧边栏出现“□”或空白，第一反应就是去折腾文件编码。其实，这里有个常见的误区：侧边栏的文字渲染机制，和编辑区是完全两套系统。你修改default_encoding或者fallback_encoding，对侧边栏是根本不起作用的。问题的根源，通常出在字体缺失，或者主题（theme）配置没有正确应用到sidebar_label这个显示类上，跟文件本身是不是UTF-8、有没有BOM头，其实都没关系。
必须手动写 .sublime-theme 文件配字体
那么，关键点来了。侧边栏的样式只认主题文件里明确定义的class，其中核心就是"class": "sidebar_label"这一项。你在全局设置里调整font_face，对它来说是无效的。
具体怎么操作呢？跟着下面几步走：
- 通过菜单栏的 Preferences → Browse Packages…，进入
User/目录。 - 新建一个纯文本文件，命名为
sidebar-fix.sublime-theme。 - 写入下面这段最小化有效配置（注意，JSON格式的引号和逗号一个都不能错）：
[{
"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 Text（关闭软件再重新打开），仅仅使用Cmd/Ctrl+R重新加载窗口，是不会重新加载主题配置的。
Linux 用户额外三步绕不开
对于Linux用户来说，情况往往更复杂一些。即使上面的主题文件写对了，还可能卡在下面几个环节：
- 系统中文字体缺失：运行
sudo apt install fonts-noto-cjk（适用于Ubuntu/Debian系）或对应的安装命令，把字体包先装上。 - 输入法前端不完整：可能需要安装
fcitx5-frontend-gtk3和fcitx5-frontend-qt5这类包。 - IMESupport插件失效：通过Package Control安装的旧版插件可能已经不管用了，需要手动下载社区维护的修改版，放进
Packages/IMESupport/目录，并卸载原来的版本。
另外，网上有些教程会建议调整dpi_scale参数。比如设为1.0据说能“解决方块”。实际上，这方法治标不治本——它只是把整个用户界面（包括菜单、标签页）都按比例缩小了，侧边栏的字看起来小了，但方块问题可能只是被掩盖了。这算不上修复，更像是一种妥协。
macOS / Windows 用户重点查字体名
如果你是macOS用户，配置就相对简单。可以直接使用系统自带的高质量字体，例如"font.face": "PingFang SC"或者"Helvetica Neue"。Windows用户则常用"Microsoft Yahei"、"SimHei"，或者前面提到的"Noto Sans CJK SC"。
这里有个细节需要注意：字体名称的拼写必须绝对准确，大小写和空格都不能错。Sublime Text在这方面很“固执”，如果字体名没匹配上，它不会报错，也不会尝试回退到其他字体，而是直接静默地显示为方块。
如何验证配置生效了呢？重启Sublime后，打开一个包含中文文件或文件夹路径的项目，观察侧边栏显示是否正常。如果问题依旧，别急着改配置，先去系统字体库里确认一下，你指定的那个字体是否真的已经安装好了，而不是仅仅凭印象猜测。
