a file icon装了但侧边栏仍是纯文字，根本原因是插件未激活、主题不支持图标class（如default/slush&poppies）、或file_icons未置于settings–user顶层；需启用插件、切换兼容主题（如adaptive/ayu）、运行rebuild icons并重启。
为什么A File Icon装了但侧边栏还是纯文字？
不是插件没装好，是它根本没被激活，或者当前主题压根不认它的图标 class。A File Icon 只负责往 DOM 元素里加 icon-js、icon-folder 这类 class，渲染全靠 UI 主题里的 CSS 规则。默认的 Adaptive.sublime-theme 支持，但 Default.sublime-theme 和 Slush & Poppies.sublime-theme 完全没预留图标占位区——结果就是留白或问号。
-
file_icons必须出现在Preferences → Settings – User的 JSON 顶层，不能嵌在"theme"或其他对象里 - 必须手动切换 UI 主题：Ctrl+Shift+P → 输入
UI: Select Theme→ 选Adaptive.sublime-theme或Ayu.sublime-theme（别用 Material 等第三方主题凑合，常漏映射新后缀） - 已装错主题？先执行
Package Control: Remove Package卸载，再重装，否则缓存干扰判断
A File Icon: Rebuild Icons 命令不生效怎么办？
插件安装或升级后，SVG 图标资源不会自动下载和注入。不运行这步，class 虽然挂上了，但对应 SVG 文件根本不存在，渲染引擎拿不出图形。控制台卡住或报 AFileIcon: failed to inject icon classes，大概率是网络受限或 Sublime Text 版本低于 4.4192。
- 务必确认 Sublime Text 版本 ≥
4.4192：Help → About Sublime Text 查右下角版本号，低版本静默失效 - 运行命令前确保已重启编辑器——
.sublime-theme文件只在启动时加载 - 重建失败后，手动删掉
Packages/User/AFileIcon/下所有缓存文件再试 - ST4 用户必须用 A File Icon v3.0+；v2.x 在 ST4 下 class 注入机制不全
路径和配置写错导致图标静默回退
Sublime 不会报错提示“图标加载失败”，而是直接跳过，侧边栏照常显示文字。最隐蔽的问题是 ignored_packages 里误加了 "Default" 或 "Theme - Default" ——这会让原生主题资源彻底不加载，所有图标 class 失去渲染入口。
- 检查
Preferences → Settings – User是否含"ignored_packages": ["Default"]，有就删掉 -
"file_icons": true拼写必须准确，"file_icon"或"file_icons_enabled"都无效 - 路径大小写敏感：macOS/Linux 下
ayu-mirage.tmTheme≠Ayu-Mirage.tmTheme - 别把
.tmTheme直接改后缀成.sublime-color-scheme，格式不兼容，得用在线工具转换
Material Theme 激活后图标仍不显示？
Material Theme 安装后不会自动启用图标支持，必须手动开启配套开关。只靠菜单里点 Preferences → Theme… 选中，往往只改了标签页样式，侧边栏图标仍走默认逻辑。
- 必须运行
Material Theme: Activate theme命令（Ctrl+Shift+P 输入后回车），它会一次性写入theme、color_scheme和material_theme_small_file_icons等关键配置 - 确认用户设置里有
"material_theme_small_file_icons": true，否则图标尺寸太小或不渲染 - 若命令面板搜不到该命令，说明插件未加载，重启 Sublime 后重试
- 别混用主题：已启用 Material Theme 时，再手动设
"file_icons": true可能冲突，优先用它自己的图标开关
复杂点在于，图标是否出现取决于三者同时成立：Sublime 版本达标、UI 主题支持图标 class、用户设置顶层启用开关——少一个，就只剩文字。最容易被忽略的是 ignored_packages 和版本硬门槛，这两项不查，重装十遍也没用。
