a file icon需通过package control安装作者sublimelsp的正版并重启生效，仅兼容sidebar_tree主题（如soda、material theme），且须检查排除规则、项目配置及多窗口插件同步问题。
Sublime Text 本身不支持文件图标，A File Icon 只是用 CSS 覆盖了侧边栏文字前的默认小方块——它不生成真实图标文件，也不改变系统或项目结构。
怎么装 A File Icon 才不冲突
别用 Package Control 直接搜 “A File Icon” 并安装，那会装错包（实际是旧版或镜像分支）。正确做法是：
- 打开 Package Control →
Package Control: Install Package - 输入并选中
A File Icon（作者是sublimelsp，不是kkga或其他） - 装完后重启 Sublime Text —— 不重启，图标不会生效
- 如果已装错，先用
Package Control: Remove Package卸载，再重装
A File Icon 需要配什么主题才显示图标
它只在支持 sidebar_tree 的 UI 主题里工作。默认的 Adaptive 或 Default 主题不支持，图标区域会留白或显示问号。
- 推荐搭配
Theme - Soda、Material Theme或ayu - 装好主题后，在
Preferences → Theme里选对应项（如Material-Theme.sublime-theme） - 部分主题需额外开启图标开关，比如
Material Theme要在用户设置里加："material_theme_small_file_icons": true
图标没变？检查这三处硬编码配置
常见“装了但没反应”，往往卡在这几个地方：
-
file_exclude_patterns或folder_exclude_patterns里写了"*.md"这类通配符 ——A File Icon会跳过被排除的文件，不渲染图标 - 项目里有
.sublime-project，且里面覆盖了"theme"或"color_scheme"，但没同步更新图标相关设置 - 你打开了多个窗口，只在其中一个里装了插件，而当前编辑的文件在另一个无插件的窗口中
图标样式本质是字体图标 + CSS 规则，没有“高清”“矢量缩放”概念；换主题或改字号时，图标可能错位或截断——这不是 bug，是 Sublime 的渲染限制。真要稳定显示，就别频繁混搭主题和插件版本。
