sublime侧边栏图标不显示的主因是主题不支持或配置错误：a file icon仅打标签，图标显示由.theme文件中icon-file-type-*和icon_folder规则决定；material、ayu、afileicon系列主题实测有效，default等默认主题无图标规则。
Sublime 侧边栏图标不显示，90% 不是插件没装好，而是主题不支持或配置没对齐——A File Icon 本身不画图，它只打标签（比如 icon-file-type-js），真正决定“有没有图标”“什么颜色”“大不大”的，是当前启用的 .sublime-theme 文件。
哪些主题真能显示图标？Material、Ayu、AFileIcon 系列最稳
别信“支持图标”的宣传语，得看主题源码里有没有定义 icon-file-type-* 和 icon_folder 这两类 class 的渲染规则。实测有效的有：
-
Material-Theme.sublime-theme：图标丰富、配色统一，但需在用户设置里加"material_theme_icons_tree_view": true才激活侧边栏图标 -
ayu-dark.sublime-theme/ayu-mirage.sublime-theme：轻量简洁，开箱即用，colored_folders默认开启，文件夹带色 -
AFileIcon Dark.sublime-theme：专为 A File Icon 设计，图标尺寸和间距更协调，但仅适配该插件，换其他插件可能失效
踩坑提示：Default.sublime-theme、Slush & Poppies、Seti_UI（旧版）压根没写图标规则，开了 file_icons 也白搭；如果设置里硬写了 "theme": "Default.sublime-theme"，会直接覆盖你选的主题。
A File Icon 设置里必须开的三个开关
插件安装完只是第一步，以下三项必须手动确认，缺一不可：
-
"file_icons": true要放在 Preferences → Settings – User 的顶层 JSON 里，不能嵌套在"theme"或其他对象中 -
"colored_folders": true必须显式开启，否则文件夹永远是灰白小三角；它和文件图标逻辑分离，不依赖扩展名 -
"draw_white_icons": false（默认是false，但有人手抖开过）——开它会让所有图标变灰白，关掉才能恢复彩色
改完保存，不用重启，侧边栏立刻响应；如果还不生效，说明主题没选对，或者 ignored_packages 里误加了 "A File Icon"。
怎么让 .env、.conf 这类文件也带图标？别乱填后缀
A File Icon 内置识别约 200 种扩展名（如 .js、.py），但 .env、.tfvars、.editorconfig 这些默认不处理。要加图标，必须走 file_extensions 映射：
- 打开 Preferences → Package Settings → A File Icon → Settings – User
- 填入合法 JSON，例如：
{ "file_extensions": { "env": "gear", "conf": "gear", "tfvars": "terraform" } } - 注意：
"env"✅（无点、小写），".env"❌，"ENV"❌；值只能是插件内置图标名，如"gear"、"html"、"folder"，不能填"cog"或路径
映射完别急着重启，先按 Ctrl+Shift+P 执行 A File Icon: Purge Icon Cache，再执行 A File Icon: Rebuild Icons——缓存不清理，新规则永远不会生效。
图标刷新失败？先查这三处，别反复重启
图标卡住不动，不是 Sublime 坏了，是资源绑定没更新。以下操作比重启更有效：
- 命令面板执行
A File Icon: Purge Icon Cache（清空旧字体/图标缓存） - 紧接着执行
A File Icon: Rebuild Icons（重新生成 SVG 图标资源并绑定扩展名） - 检查项目级配置：如果当前项目有
.sublime-project文件，打开它看看有没有硬编码的"theme"或"color_scheme"，它们会覆盖全局设置
最后提醒一句：A File Icon 只作用于侧边栏 DOM 元素，标签页顶部、状态栏、系统托盘图标都不会变——这不是缺陷，是设计如此。想改其他地方，得动 .sublime-color-scheme 或自定义主题文件。
