真正支持sublime text图标的主题必须含xxx.sublime-theme文件及icons/目录（含folder.png、js.png等），仅提供.tmtheme配色文件的主题无法显示侧边栏图标。
怎么判断一个图标主题是否真支持 Sublime Text
很多图标主题标榜“支持 Sublime”，实际只提供 .tmTheme 配色文件，根本没做 Default.sublime-theme 或 icon_*.png 资源——这类主题只能改编辑区颜色，不会改变侧边栏文件图标。真正可用的图标主题必须包含 theme 文件（通常是 xxx.sublime-theme）和配套的 icons/ 目录（含 folder.png、js.png 等）。安装后若侧边栏仍是默认小方块，大概率是主题压根没提供图标资源。
安装路径和启用方式容易错在哪
Sublime Text 的图标主题不是靠 Package Control 自动激活的，必须手动修改 Preferences.sublime-settings。常见错误包括：
- 把主题名写成文件夹名（如
Ayu），实际应写theme文件里的"name"字段值（比如"Ayu Dark.sublime-theme"） - 路径写错：主题文件必须放在
Packages/User/或Packages/YourThemeName/下，不能丢进Installed Packages/ - 漏掉
"theme": "xxx.sublime-theme"这行，只改了"color_scheme"
正确做法：打开 Preferences → Settings，在右侧用户设置里加一行："theme": "Origami.sublime-theme"（注意引号和后缀）。
为什么有些图标主题在 macOS 上显示异常
macOS 对图标的尺寸和透明度更敏感。例如 FileIcons 主题默认用 16×16 图标，但 Sublime 在 macOS 上会尝试拉伸到 20×20，导致模糊或错位；部分主题用 alpha 通道做高亮态，而 macOS 的渲染引擎可能忽略该通道。临时解法是：
- 检查主题目录下是否有
osx/子目录，优先用里面的图标 - 在
.sublime-theme里搜索"layer0.opacity"，把值从0.7改成1.0避免图标发虚 - 避免使用依赖 SVG 图标的主题（Sublime 不支持 SVG 图标）
性能影响比你想象中明显
图标主题不是纯静态资源。每次文件树刷新、拖入新文件夹、甚至切换标签页，Sublime 都要按规则匹配扩展名→查图标映射表→加载 PNG。像 FileIcons 这类支持 500+ 后缀的主题，会在首次加载时多花 200–400ms，且内存占用增加 8–12MB。如果你常开 30+ 文件或用 WSL2 同步目录，建议：
- 删掉
icons/_custom/里不用的图标（比如你不用 Erlang，就删掉erl.png） - 关闭动态图标功能：在
.sublime-theme中注释掉所有含"file_icons_dynamic"的块 - 用轻量主题如
Flatland或Material Theme的精简版（它们把图标合并成雪碧图，减少 IO 次数）
图标主题的复杂度藏在细节里：一个没声明 "content_margin" 的 folder_icon 可能让整个侧边栏文字错位两像素，而这种问题往往要打开 DevTools（Ctrl+Shift+P → Developer: Toggle DevTools）才能定位。别只看预览图，真装上跑十分钟文件操作再判断。
