图标不显示需同时满足三条件：file_icons布尔值置于settings–user顶层、启用支持图标的主题（如material-theme）、安装sublimelsp作者的a file icon插件；缺一不可。
主题和 file_icons 开关必须同时生效
图标不显示，90% 的情况不是插件没装，而是 file_icons 设置没写对位置，或当前主题根本不画图标。这个布尔值必须出现在 Preferences → Settings – User 的 JSON 顶层，不能嵌套在 "theme_settings" 或其他对象里；拼成 file_icon、file_icons_enabled 或写成字符串 "true" 都无效。
同时，"theme" 字段必须设为真正支持图标的主题，比如 "Material-Theme.sublime-theme" 或 "ayu-dark.sublime-theme"。别信名字带 “Adaptive” 就行——Adaptive.sublime-theme（ST4 自带）默认不含图标渲染规则，改设置也没用。
- 临时验证：切回
Material-Theme，再运行命令AFileIcon: Rebuild Icon Cache，比重启快 - 如果项目级
.sublime-project文件里也写了"theme"或"file_icons"，它会覆盖全局设置，得一并检查
别装错作者的 A File Icon 插件
Package Control 搜 A File Icon 会列出多个同名包，但只有作者是 sublimelsp 的那个才兼容 ST4.4192+ 并正确响应 file_icons 开关。kkga、braver 等分支版本在冷门后缀（如 .env、.toml）上常失效，甚至和 file_icons 配置项冲突。
- 安装时务必手动输入
A File Icon并核对下拉项中的作者字段 - 已装错？先执行
Package Control: Remove Package卸载，再重装 - 装完必须完全退出 Sublime（不是关窗口），再启动——
.sublime-theme只在启动时加载
ignored_packages 会静默屏蔽图标逻辑
插件文件夹明明在 Packages/ 下，但图标就是不出现，大概率是 "ignored_packages" 把 A File Icon 列进去了。这个设置项在 Preferences → Settings 右侧用户配置中，常见值如 ["Vintage", "Origami"]，如果你顺手加了 "A File Icon" 或通配符匹配到了它，插件根本不会加载。
- 检查该字段是否存在，确认
"A File Icon"不在其列表中 - 删掉对应项，或整行改成字符串（如
"// ignored_packages": ["A File Icon"]）临时禁用（JSON 不支持注释，但 Sublime 允许这种 hack） - 保存后必须完全退出再重启，缓存不清理，图标区永远留白
冷门后缀图标要靠 extensions 映射，不是自动识别
A File Icon 默认只认约 200 种扩展名。.env、.prettierrc、.astro 这类文件不会自动匹配图标，必须手动映射到它内置的图标标识符上，比如 "settings"、"config"、"html"——这些名字来自插件 Default Settings 的 icon_names 字段，不能自定义为 "dot_env" 或随便起名。
操作路径：Preferences → Package Settings → A File Icon → Settings – User，添加：
{"extensions": {".env":"settings",".toml":"config",".astro":"html"}}
- 改完保存，必须重启 Sublime Text——
AFileIcon: Rebuild Icon Cache命令不加载新extensions映射 - 确保你用的主题确实预留了
"class": "file_icon"图层，否则即使映射对了，也渲染不出来
最常被忽略的是：图标显示依赖三者严格对齐——插件版本 ≥4.4192、file_icons 在顶层且为 true、主题本身含图标绘制规则。缺任何一环，侧边栏就只剩空白或问号。
