sublime text 侧边栏图标显示需同时满足装对插件、启用支持图标的ui主题、手动开启file_icons开关三条件；缺一不可，且必须重启生效。
Sublime Text 侧边栏图标不会自动显示，必须同时满足三个条件：装对插件、配对支持图标的 UI 主题、手动开启 file_icons 开关——缺一不可，否则静默失效。
为什么装了 A File Icon 却没图标？
因为 A File Icon 只负责提供图标数据，不负责渲染；真正决定“能不能画出来”的是当前启用的 UI 主题。默认的 Default.sublime-theme 和 Slush & Poppies.sublime-theme 均不支持图标渲染，所以即使插件装了、配置也对，图标照样不出现。
- 必须换用明确声明支持图标的主题，比如
Adaptive.sublime-theme（Sublime 自带）、ayu.sublime-theme或Material-Theme.sublime-theme - 确认主题已生效：按
Ctrl+Shift+P输入UI: Select Theme，看带 ✔️ 的那一行是否是你想用的主题 - 部分主题（如 Material Theme）自带图标支持开关，但需运行
Material Theme: Activate theme才会写入"file_icons": true；手动配置容易漏掉这行
安装 A File Icon 插件的正确顺序
别跳过 Package Control 验证环节，很多“装不上”其实是网络或代理问题导致的假失败。
- 先按
Ctrl+Shift+P输入Package Control: Install Package，能响应说明 Package Control 已就位 - 如果提示
There are no packages available for installation，大概率是被防火墙拦截了packagecontrol.io，需检查代理设置或换网络 - 输入
A File Icon（注意大小写和空格），回车安装；安装完不要重启，但图标仍不会立刻出现 - 验证是否装成功：打开
Preferences → Package Settings → A File Icon → Settings，能看到 JSON 配置文件即表示已加载
手动配置 file_icons 的关键细节
这个字段必须是顶层键，不能嵌套在 "theme" 或其他对象里，且值只能是 true 或 false —— 写成 "file_icons": "true"（字符串）或 "file_icons": 1 都无效。
- 编辑
Preferences → Settings – User，添加这一行："file_icons": true - 确保它和其他字段同级，例如：
{ "theme": "Material-Theme.sublime-theme", "file_icons": true } - 改完保存后必须重启 Sublime Text，ST4 缓存机制极强，不重启旧状态会残留
- 如果用了多个图标插件（如 A File Icon + FileIcons），它们可能冲突；建议只留一个，并禁用另一个的包
图标还是不显示？检查这三个硬性点
90% 的“没反应”问题都卡在这三处，重装插件反而浪费时间。
-
file_extensions映射缺失：A File Icon 默认只识别常见后缀（.js、.py、README.md等），像.env、.yml或自定义扩展名需手动加映射——进Preferences → Package Settings → A File Icon → Settings，往"file_extensions"数组里加项 - 图标被其他插件覆盖：
SideBarEnhancements或Origami会重绘侧边栏，导致图标被压住或错位；查其设置里是否有"draw_sidebar_arrows"，设为false可缓解 - 主题本身禁用了图标：某些精简版主题（如部分 Soda 变体）硬编码关闭了图标区域；此时换主题比调参数更直接
最容易被忽略的是重启动作和 file_icons 字段的位置——它必须顶格、独立、布尔值、保存后重启，四者少一个，图标就永远出不来。
