sublime侧边栏图标不显示，90%因插件与主题未配对启用——需确保启用a file icon或fileicons之一，并搭配支持图标的主题（如material-theme），同时检查设置中无"file_icons": false、主题未被硬编码覆盖、自定义扩展名映射格式正确。
Sublime 侧边栏图标不显示，90% 是因为没配对启用图标插件和兼容主题——装了 A File Icon 却用 Default.sublime-theme，等于给 SVG 赋了 class 却没定义 CSS 规则。
FileIcons 和 A File Icon 到底选哪个
两者都通过 Package Control 安装，但行为差异明显：
-
FileIcons：零配置、即装即用，不依赖主题重写，Default和Adaptive主题下也能显示彩色图标；无运行时逻辑，性能开销几乎为零 -
A File Icon：图标库更全（比如支持.tfvars、.env.local），但必须手动执行A File Icon: Rebuild Icons才能生效；若主题不支持icon-file-type-*类名，图标直接不渲染 - 别混着装：二者会冲突，
ignored_packages里会静默禁用其中一个；建议只留一个，卸载另一个用Package Control: Remove Package
图标不显示？先查这三处硬性条件
不是插件坏了，是链路断在某个环节：
- 用户设置里不能有
"file_icons": false—— 即使装了插件，这行也会全局屏蔽图标；删掉或显式设为true - 当前启用的主题必须含图标规则：
Material-Theme.sublime-theme、ayu-dark.sublime-theme、AFileIcon Dark.sublime-theme可用；Default、Soda、Boxy等老主题不支持，改了设置也白搭 - 检查
Preferences → Settings – User里是否硬编码了"theme": "Default.sublime-theme"—— 这会覆盖你在 Theme 菜单里选的任何主题
自定义 .env、.conf 等小众后缀图标要严格按格式
默认图标映射不到所有扩展名，手动加需满足三个铁律：
- 键名必须是小写、无点：
"env"✅，".env"❌，"ENV"❌ - 值必须是插件内置图标名：
"gear"、"terraform"、"flask"—— 不能填"cog"或自定义 SVG 路径 - 必须包在
"file_extensions"对象里：{"file_extensions": {"env": "gear"}}✅，{"env": "gear"}❌
填错任意一项，整块 JSON 静默失效，图标不会 fallback，只会保持默认样式。
图标缓存卡住？别重启，先清再建
改完设置或升级插件后图标不动，大概率是缓存没刷新：
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P） - 依次执行：
A File Icon: Purge Icon Cache→A File Icon: Rebuild Icons（如果是FileIcons，执行FileIcons: Rebuild） - 已打开的项目侧边栏会立刻更新；如果仍不显示，检查
ignored_packages是否误加了插件名
图标只作用于侧边栏 DOM 元素，标签页顶部、搜索结果、预览区都不会显示——这不是 bug，是设计如此，别浪费时间找“全局图标开关”。
