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/ 目录比反复重启更有效。
