侧边栏图标不显示，首要原因是主题未配对：必须切换至AFileIcon Dark/Light.sublime-theme，运行A File Icon: Rebuild Icons命令，并确认ignored_packages未禁用Default主题；若想保留当前主题又隐藏图标，只需在用户设置中设"file_icons": false。
侧边栏图标不显示？先确认是不是主题根本没配对
装了 A File Icon 但侧边栏只有文字没图标，90% 是因为当前主题压根不认识 icon-js、icon-folder 这类 class。Sublime 原生的 Adaptive.sublime-theme 和大多数第三方主题（比如 Material Theme、ayu）默认不定义这些 CSS 规则，插件注入了 class 也白搭。
必须手动切换到明确支持的 UI 主题：AFileIcon Dark.sublime-theme 或 AFileIcon Light.sublime-theme。Preferences → Theme… 里选它，别凑合——标榜“兼容”的主题常漏掉 icon-svelte、icon-tsx 等新扩展名映射。
还要检查 ignored_packages 设置里有没有 "Default" 或 "Theme - Default"：有就删掉，否则 Sublime 会跳过加载原生主题资源，连图标 class 的渲染入口都断了。
A File Icon: Rebuild Icons 必须手动运行
插件安装或升级后，SVG 图标资源不会自动下载和注入。不执行这步，DOM 里可能有 icon-js class，但对应 SVG 文件根本不存在，渲染引擎拿不出图。
操作步骤：
- Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）
- 输入
A File Icon: Rebuild Icons回车 - 看控制台（Ctrl+`）是否有进度提示；若卡住或报
AFileIcon: failed to inject icon classes，大概率是网络受限或 ST 版本低于4.4192 - ST4 用户务必确认插件已是 v3.0+（旧版 v2.x 在 ST4 下 class 注入机制不全）
重建后仍无图标？临时删掉 Packages/User/AFileIcon/ 目录下所有缓存文件再试。
想保留当前主题又不要图标？直接关插件渲染
如果你喜欢 Material Theme 或 One Dark 这类视觉风格，但就是不想看到侧边栏图标，别折腾主题切换——最干净的做法是让 A File Icon 插件“不干活”。
打开 Preferences → Package Settings → A File Icon → Settings，在右侧用户设置中加一行：
"file_icons": false
保存后图标立刻消失，主题照常生效，且不影响其他插件行为。注意不是 "enabled": false（那会禁用整个插件），而是只关图标渲染。
这个设置优先级高于主题层，哪怕你后续切回 AFileIcon Dark，只要 file_icons 是 false，图标就不会出现。
侧边栏空着或图标错位？检查 folder_exclude_patterns 和项目加载方式
图标显示异常有时跟路径过滤有关。比如用户设置里写了 "folder_exclude_patterns": ["*"] 或 "folder_exclude_patterns": ["."] ，会导致整个项目结构被过滤，侧边栏压根没内容可渲染图标。
验证方法：在 Preferences → Settings 用户设置中给这行加 // 注释，保存后按 Ctrl+K, Ctrl+B 刷新视图。
另一个常见原因是没正确加载项目：
- 只用
File → Open File打开单个main.py，侧边栏必然为空——这不是 bug，是设计 - 必须用
File → Open Folder…（Win/Linux）或File → Open…并选中整个文件夹（macOS） - 想追加路径而非重置：按
Ctrl+Shift+P输入Project: Add Folder to Project回车
误用 Open Folder… 会清空所有已有路径，之前加的文件夹全丢；更隐蔽的是用户设置里有 "project": null，也会强制清零项目上下文，有就删掉。
