a file icon图标不显示是因为theme、file_icons、icon_theme三者未对齐或主题未定义渲染规则：插件只打class（如icon-js），真正渲染依赖.sublime-theme中对应css规则；file_icons必须位于settings–user顶层且为布尔true；须选用material-theme等支持图标主题并重启。
图标显示错误，90% 不是插件装错了，而是 theme、file_icons、icon_theme 三者没对齐，或主题本身压根没定义图标渲染规则。
为什么装了 A File Icon 还是没图标？
A File Icon 只负责给文件节点打 class（比如 icon-file-type-js），不负责画图。真正决定“有没有图标”“长什么样”的，是当前启用的 .sublime-theme 文件里有没有对应 class 的渲染规则。
-
Default.sublime-theme和Adaptive.sublime-theme（哪怕名字带 “Adaptive”）都不含icon_folder或icon_file_type规则，装了也白装 - 必须换用明确支持图标的主题，如
Material-Theme.sublime-theme、Ayu-dark.sublime-theme、AFileIcon Dark.sublime-theme - 验证方式：用 PackageResourceViewer 打开当前 theme 文件，搜索
"class": "icon_folder"—— 没这行就注定没文件夹图标
配置项写错位置或值类型，图标直接静默失效
file_icons 必须出现在 Preferences → Settings – User 的 JSON 顶层，且值必须是布尔型 true；写成字符串 "true"、嵌套在 "theme" 对象里、拼成 file_icon，全都不生效。
- 常见错误：
"file_icons": "true"（字符串）→ 无效；"file_icons": true（布尔）→ 有效 -
"theme"值必须带完整后缀："Material-Theme.sublime-theme"，不能写成"Material Theme"或"Material-Theme" -
"icon_theme"字段大小写敏感："A File Icon"正确，"a file icon"或"Afileicon"都被忽略 - 项目级设置（
.sublime-project）会覆盖全局设置，检查里面是否误写了"file_icons": false或清空了"theme"
文件被排除、后缀未映射、主题未激活，图标照样不出现
即使 theme 和 file_icons 都对了，图标仍可能空白——问题出在路径过滤、冷门后缀识别或 UI 主题未真正启用上。
-
folder_exclude_patterns写成["*"]或["."]，整个项目结构被过滤，侧边栏空着，自然没图标可显示 -
.env、.toml、.zshrc等非标准后缀默认无图标，需手动在Preferences → Package Settings → A File Icon → Settings – User中添加file_extensions映射 - Material Theme 安装后不会自动启用全部 UI 层，必须运行命令
Material Theme: Activate theme（Ctrl+Shift+P 输入执行），否则只改了标签页，侧边栏仍用默认渲染 -
ignored_packages若误加了"Default"或"Theme - Default"，会导致基础 UI 组件丢失，图标区域直接塌陷
重启不是可选项，是硬性步骤
.sublime-theme 文件只在 Sublime 启动时加载一次，安装插件、改配置、换主题后不重启，所有变更都停留在内存里，不会反映到界面。
- 装完
A File Icon或换完 theme 后，必须完全退出 Sublime（Windows/Linux 关掉所有窗口，macOS 用 Cmd+Q），再重新打开 - 临时验证可用
AFileIcon: Rebuild Icon Cache命令，但仅限已启用图标的场景；若 theme 根本不支持图标，这命令也刷不出东西 - 切回
Adaptive.sublime-theme再切回来，不会触发重载；只有重启才强制重新解析所有 theme 规则
最容易被忽略的是：图标显示依赖三重确认——插件是否真由 sublimelsp 维护、theme 是否真含 icon class 规则、file_icons 是否在顶层设为布尔 true。少一个，侧边栏就只剩文字和问号。
