VSCode侧边栏图标消失最常见原因是误触Ctrl+B/Cmd+B快捷键导致隐藏，按该组合键可立即恢复；若无效，需检查配置项workbench.activityBar.visible是否为false、插件冲突或全屏模式影响。
侧边栏图标丢失，八成不是插件没装，而是主题不匹配 + 图标缓存未重建 —— 两者缺一不可。
为什么 A File Icon 装了却没图标
A File Icon 不直接画图标，只往侧边栏 DOM 元素里加 icon-js、icon-folder 这类 class；真正负责渲染图标的，是当前启用的 UI 主题里的 CSS 规则。默认的 Adaptive.sublime-theme 或 Default Dark.sublime-theme（未打补丁版）根本不认识这些 class，所以图标永远空白。
- 必须手动切换到明确支持该插件的主题：Preferences → Theme… → 选
AFileIcon Dark.sublime-theme或AFileIcon Light.sublime-theme - 别用第三方主题（如 Material、ayu）凑合——即使它们自称兼容，也可能漏掉部分 class 映射，导致
.astro、.svelte等新扩展名无图标 - 误在
ignored_packages里加了"Default"或"Theme - Default"？这会直接让所有主题资源加载失败，图标 class 彻底失效
A File Icon: Rebuild Icons 必须手动运行
插件安装或升级后，SVG 图标资源不会自动下载和注入。不执行这步，icon-* 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 - Sublime Text 4 用户务必确认插件已是 v3.0+（旧版 v2.x 在 ST4 下 class 注入机制不全）
- 重建后仍无图标？临时删掉
Packages/User/AFileIcon/目录下所有缓存文件再试
自定义扩展名图标要改 Settings – User，别碰插件自带配置
想让 .astro 显示 HTML 图标、.ts 显示 JS 图标，不能去改插件目录下的 AFileIcon.sublime-settings——下次更新插件时会被覆盖。
- 正确路径：Preferences → Package Settings → A File Icon → Settings – User
- 加入映射规则，例如：
{ "file_extensions": { "astro": "html", "ts": "javascript" } } - 注意语法：key 是扩展名（不含点），value 是目标图标类型（必须是插件已支持的类型名，如
html、javascript、folder） - 改完保存，无需重启，但需重新触发一次
A File Icon: Rebuild Icons才能生效
图标 class 到底有没有挂上去？先 inspect 再排查
图标不出现，第一步不是重装插件，而是确认底层 class 是否真注入成功。右键侧边栏任意文件 → Inspect Element（需已启用 DevTools 插件，或用 ST 自带调试模式），看 DOM 元素是否含 icon-html、icon-folder 等 class。
- 没有 class？说明插件监听失败：检查命令面板中
A File Icon: Enable是否返回 enabled；确认用户设置中"enabled": true - 有 class 但没图？回到主题切换步骤，或检查控制台是否有
AFileIcon: failed to load theme类报错 - class 名对不上（比如显示
icon-file-type-js而非icon-js）？说明插件版本与主题不匹配，需同步升级
最常被忽略的一点：图标显示依赖两层链路——插件注入 class + 主题提供样式。断掉任意一环，都是白屏。别跳过 A File Icon: Rebuild Icons，也别指望“装完就自动好”。
