图标主题失效主因是file_icons开关位置错误或主题不支持；必须在Settings–User顶层设为"file_icons": true，换用Material-Theme等支持图标主题，并确保A File Icon插件由sublimelsp发布且运行Rebuild Icons命令。
图标主题失效，90% 是因为 file_icons 开关没开在正确位置，或当前 theme 根本不支持图标渲染——不是插件坏了，是它压根没被调用。
确认 file_icons 是否真正启用
这个开关必须出现在 Preferences → Settings – User 的 JSON 顶层，不能嵌套、不能拼错、不能是字符串：
-
"file_icons": true✅（唯一有效写法） -
"file_icons": "true"❌（字符串值不生效） -
"file_icon": true❌（少个s，完全无效） -
{"theme_settings": {"file_icons": true}}❌（嵌套在对象里，被忽略）
改完保存后必须重启 Sublime Text —— 缓存不刷新，file_icons 就只是个摆设。
检查当前 theme 是否支持图标
图标不是插件“画”出来的，而是 UI 主题通过 class: "file_icon" 规则渲染的。默认的 Default.sublime-theme 和 Adaptive.sublime-theme 都不含该规则，所以哪怕插件装对、开关开了，图标区也永远空白。
- ✅ 推荐直接换用已内置图标支持的主题：
Material-Theme.sublime-theme、ayu-dark.sublime-theme、Theme - Soda - ⚠️ 若用
Material-Theme，还需确保用户设置中包含："material_theme_file_icons": true - ❌ 别手动编辑
Packages/Theme - Default/Default.sublime-theme—— 升级后会被覆盖，且它本身就不支持图标
验证 A File Icon 插件是否装对且生效
Package Control 搜索“A File Icon”会列出多个同名包，但只有作者为 sublimelsp 的版本在 ST4 下稳定支持图标注入：
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 手动输入A File Icon→ 在下拉项中核对作者字段是否为sublimelsp - 装完立刻重启；不重启，
.sublime-theme文件不会重载，图标 class 永远挂不上 - 运行命令
A File Icon: Rebuild Icons（不是Rebuild Icon Cache）—— 这步会下载并注入 SVG 资源，缺了就只显示问号或留白
若控制台报 AFileIcon: failed to inject icon classes，大概率是 ST 版本低于 4.4192 或网络受限导致 SVG 下载失败。
自定义扩展名图标映射必须写对格式
像 .env、.toml、.astro 这类文件默认无图标，需手动映射到插件内置的图标标识符上，不是随便起名：
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 填入：
{"extensions": {".env": "settings", ".toml": "config", ".astro": "html"}} -
"settings"、"config"是插件预置的图标名（见其 Default Settings 的icon_names字段），写成"dot_env"或"env_file"会 fallback 到默认文档图标 - 保存后必须重新运行
A File Icon: Rebuild Icons，仅重启不够
最易被忽略的一点：项目级设置（.sublime-project）里的 "file_icons" 或 "theme" 会覆盖全局设置，排查时先临时移除项目配置再试。
