Sublime侧边栏图标需A File Icon插件、兼容UI主题及正确配置三者协同；缺一不可，常见问题包括Package Control未安装、未执行Rebuild Icons、主题不支持、file_icons未启用或.colored_folders关闭。
Sublime 侧边栏图标不会“自动变漂亮”，它依赖 A File Icon 插件 + 兼容的 UI 主题协同工作；单独装插件或单独换主题，90% 情况下图标仍不显示。
安装 A File Icon 前必须确认 Package Control 可用
几乎所有失败都卡在这一步：命令面板调不出来、Package Control: Install Package 无响应、或提示 “There are no packages available”。这不是插件问题，而是 Package Control 没装好或被拦截。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）必须能弹出命令面板；不能，说明 Package Control 没装好或被防火墙/杀毒软件/公司网络屏蔽了packagecontrol.io - 打开
Preferences → Package Settings，看有没有Package Control项；没有就重装——去官网复制对应系统的安装代码，粘贴进View → Show Console执行
A File Icon 安装后必须立即执行 Rebuild Icons
装完不执行这步，图标资源不会下载，缓存不会生成，扩展名映射也不会建立——等于白装。
- 安装完成后，**不要关掉 Sublime**，立刻再按
Ctrl+Shift+P，搜索并执行A File Icon: Rebuild Icons - 执行完建议完全退出再重开，避免 UI 主题未热加载导致图标不渲染
- 如果之后改过配置或新增了冷门后缀（如
.env、.toml），也得再跑一次这个命令
图标不显示？八成是主题没对齐或设置冲突
Sublime 的侧边栏图标不是靠插件“画出来”的，而是由当前启用的 .sublime-theme 文件定义图标的尺寸、位置、纹理路径。A File Icon 只提供图标数据，不提供渲染逻辑。
- 菜单进入
Preferences → Theme，选一个明确支持图标的主题，比如：Material-Theme.sublime-theme、ayu-dark.sublime-theme或AFileIcon Dark.sublime-theme -
Preferences → Settings – User中必须有顶层字段"file_icons": true，不能嵌套在"theme"或其他对象里 - 检查是否误启用了
"draw_white_icons": true（在Preferences → Package Settings → A File Icon → Settings中），这个选项会让所有图标变灰白，关掉即可 - 项目根目录若有
.sublime-project文件，打开看看有没有硬编码的"theme"，它会覆盖全局设置，导致图标突然消失
文件夹没图标？colored_folders 默认关闭
A File Icon 默认只给文件加图标，文件夹图标是另一套逻辑，且默认关闭彩色文件夹（colored_folders）。如果你看到文件有图标但文件夹还是普通小三角，就是这个开关没开。
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加配置：
{"colored_folders": true, "folder_animation": false}（folder_animation关掉可避免展开时闪烁） - 保存后无需重启，图标会立即刷新；如仍不生效，再运行一次
A File Icon: Rebuild Icons
真正容易被忽略的是：图标是否显示，取决于插件、主题、用户设置三者同时满足条件。少一个，图标就“消失”——不是坏了，是没对齐。尤其要注意 .sublime-project 文件和 Settings – User 里的 "file_icons": true 是否被意外覆盖或写错位置。
