侧边栏图标不显示需依次检查：启用A File Icon（删或设"file_icons": true）、切换支持图标的主题（如Material-Theme）、正确配置扩展名映射（小写无点）、重建/清空图标缓存。
侧边栏图标不显示？先确认 A File Icon 是否真正启用
Sublime 默认关闭侧边栏文件图标渲染，即使装了 A File Icon 插件，也可能完全没反应——这不是插件坏了，而是它被“静默禁用”了。最常见原因是用户设置里存在 "file_icons": false，它会强制屏蔽所有图标。打开 Preferences → Settings – User，检查并删掉这行，或改为 "file_icons": true。保存后不用重启，只需折叠再展开侧边栏（或按 Ctrl+K, Ctrl+B 切换），图标就会立刻出现。
主题不兼容是图标消失的头号原因
A File Icon 本身不提供 UI 主题，它依赖外部主题支持图标渲染。如果你用的是默认主题（Default.sublime-theme）或 Adaptive，图标大概率不会显示。必须切换到明确支持图标的主题，比如：Material-Theme.sublime-theme、ayu-dark.sublime-theme 或 AFileIcon Dark.sublime-theme。操作路径是 Preferences → Theme，从下拉列表中选择带 “AFileIcon” 或 “Material”、“ayu” 字样的主题。注意：仅安装主题包不够，必须在这里手动选中它，否则插件资源无法注入侧边栏。
自定义扩展名图标要写对格式，大小写和点都不能错
想让 .env 显示齿轮图标、.conf 显示设置图标，得在 Preferences → Package Settings → A File Icon → Settings – User 里加映射。但格式非常严格：
• 左侧键名必须是小写、**无点**的扩展名（如 "env"，不是 ".env" 或 "ENV"）；
• 右侧值必须是插件内置图标名（如 "flask"、"gear"），不能自己填 SVG 路径或随便起名；
• 键值对需包在 "file_extensions" 对象里，例如：
{ "file_extensions": { "env": "flask", "conf": "gear" } }。填错一个字符，整块配置就失效，图标也不会 fallback，只会安静地保持默认样式。
图标缓存异常时，别只靠重启
安装后图标仍不刷新？可能是旧缓存卡住了。先试 Command Palette（Ctrl+Shift+P）运行：
• A File Icon: Rebuild Icons（重建图标资源）
• 若无效，再运行 A File Icon: Purge Icon Cache（清空缓存）后再重建。
这两步比反复重启 Sublime 更有效——尤其在升级插件或更换主题后。另外注意：图标只出现在侧边栏，标签页顶部、文件预览区、搜索结果里都不会显示，这不是 bug，是设计如此。
最容易被忽略的其实是“主题启用”这一步：很多人装完插件就以为结束了，却忘了去 Preferences → Theme 手动点选一次图标主题。它不像语法高亮那样自动关联，必须显式激活，否则所有配置都只是躺在硬盘里的 JSON。
