A File Icon 是唯一靠谱方案,因其持续维护、适配 ST4.4192+ 且兼容主流主题;其他插件如 FileIcons(已停更)、SidebarEnhancements(仅右键菜单)、Material Theme(需配合 A File Icon)均无法单独实现侧边栏图标。

装 A File Icon 插件是唯一靠谱方案,其他名字带 “FileIcons”“SidebarEnhancements” 或 “Material Theme” 的插件单独安装都不会让侧边栏出现文件图标。
为什么只认 A File Icon?
Sublime Text 原生不调用系统图标缓存,也不渲染资源管理器式图标——它靠插件向侧边栏 DOM 注入 CSS class(比如 icon-js、icon-py),再由主题里的规则匹配并绘制。目前只有 A File Icon 持续维护、适配 ST4.4192+、且兼容主流主题(如 Adaptive、ayu、Material-Theme)。
- 别搜
FileIcons或AFileIcon:拼错就装错包,前者是已停更的旧版,后者是命名不规范的 fork -
SidebarEnhancements只加右键菜单,和图标无关 -
Material Theme本身只是 UI 主题,不带图标逻辑,必须配合A File Icon才能显示图标
安装后图标不显示?先查这三处
90% 的“没图标”问题都卡在这三个环节,不是插件坏了,而是链路断了。
- 没重启 Sublime:尤其是 macOS 上的 ST4.42xx,不重启
A File Icon的 class 注入机制压根不启动 -
"ignored_packages": ["A File Icon"]被误加进Preferences → Settings – User:删掉这一行,或确保ignored_packages是空数组 - 当前主题不支持图标渲染:Default 和 Slush & Poppies 默认关闭图标;Adaptive 需手动开启;Material-Theme 必须加
"file_icons_material_theme": true
让 .env、.toml 这类冷门后缀也显示图标
A File Icon 内置约 200 种扩展名,但对 .env、.conf、.tfvars 等默认不识别。不能换插件,得手动映射。
- 改的是
Packages/User/AFileIcon.sublime-settings,不是插件自带的配置文件(会被更新覆盖) - 格式必须小写、无点:
"env": "config",不是".env": "config"或"ENV": "config" - 图标名必须来自内置集合:
html、js、folder、config等,拼错就 fallback 成默认文档图标 - 改完保存即可,但已打开的标签页要重新打开才生效
文件夹图标还是小三角?
A File Icon 默认不处理文件夹图标,得显式启用 colored_folders,且主题必须定义 "class": "folder_icon" 规则。
- 在
Preferences → Package Settings → A File Icon → Settings – User中加:"colored_folders": true - Adaptive、Seti_UI 不支持该特性;Material-Theme 需同时设
"material_theme_big_fileicons": true和"draw_white_icons": false - 不确定主题是否支持?用
PackageResourceViewer打开其.sublime-theme文件,搜索"class": "folder_icon"
最易被忽略的是版本和缓存:低于 ST4.4192 的版本会静默失效;图标 CSS 缓存卡住时,删掉 Cache/A File Icon/ 目录比反复重启更有效。

















