侧边栏有文件但没图标，八成是主题不匹配：必须切换至afileicon dark/light主题、运行rebuild icons命令、确保file_icons:true且ignored_packages未禁用default主题。
侧边栏有文件但没图标，八成是主题不匹配
装了 A File Icon 却没图标，不是插件没起作用，而是 Sublime 当前用的主题压根不认识 icon-js、icon-folder 这类 class。默认的 Adaptive.sublime-theme 或未打补丁的 Default Dark.sublime-theme 完全不包含对应 CSS 规则，class 挂上了也渲染不出图形。
必须手动切换到专用主题：
Preferences → Theme… → 选 AFileIcon Dark.sublime-theme 或 AFileIcon Light.sublime-theme
别凑合用 Material、ayu 等第三方主题——即使标榜兼容，也常漏掉 icon-astro、icon-svelte 等新扩展名映射。
检查是否误在 ignored_packages 里加了 "Default" 或 "Theme - Default"：这会跳过加载所有原生主题资源，图标 class 彻底失去渲染入口。
A File Icon: Rebuild Icons 必须手动运行
插件安装或升级后，SVG 图标资源不会自动下载和注入。不执行这步，icon-js 类虽可能挂上，但对应 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）
拼错就 fallback 成默认文档图标
保存后无需重启，但需重新触发一次 A File Icon: Rebuild Icons 才能生效
图标 class 没挂上？先确认插件是否真在工作
右键侧边栏任意文件 → Inspect Element（需已启用 DevTools 插件或用 ST 自带调试模式），看 DOM 元素是否含 icon-html、icon-folder 等 class。
没有？说明插件监听失败。排查步骤：
命令面板输入 A File Icon: Enable，确认状态为 enabled
打开 Preferences → Package Settings → A File Icon → Settings，检查 "enabled": true
控制台（Ctrl+`）搜 AFileIcon，看有无注入失败报错
常见疏漏点：
以为装完就完事，跳过 Rebuild Icons
网络受限导致 SVG 下载失败
ST 版本过低，动态 class 注入机制不全
插件被其他 package 覆盖或禁用
复杂点在于：图标渲染是“插件 + 主题 + 缓存”三者协同的结果，任一环节断链都会白屏；最容易被忽略的是——Rebuild Icons 不是可选项，是必做动作，且每次改了 file_extensions 映射后都得重跑一遍。
