图标主题冲突源于A File Icon、UI主题、file_icons开关三者未对齐；须安装sublimelsp官方版A File Icon，换用Material-Theme等原生支持图标主题，并确保file_icons为布尔true且位于用户设置顶层，最后重启生效。
图标主题冲突不是插件装错了，而是 A File Icon、UI 主题、file_icons 开关三者没对齐——改了设置却没反应，大概率是其中一环被绕过了。
确认 A File Icon 是 sublimelsp 官方版本
Package Control 搜索 A File Icon 会列出多个同名包，但只有作者为 sublimelsp 的版本在 ST4.4192+ 下真正支持图标映射和冷门后缀扩展。其他分支（如 kkga 或 braver）常存在规则缺失、extensions 配置无效、甚至与 file_icons 开关冲突的问题。
- 按
Ctrl+Shift+P输入Package Control: Install Package，等列表加载完后手动输入A File Icon并回车 - 安装完成后必须完全退出 Sublime Text（不是仅关闭窗口），再重启——
.sublime-theme只在启动时加载 - 已装错？先执行
Package Control: Remove Package卸载，再重装；别指望“覆盖安装”能修复
换用真正支持图标的 UI 主题
A File Icon 本身不画图，只提供图标标识符（如 "config"、"settings"）；真正负责绘制的，是当前 UI 主题里的 .sublime-theme 文件。默认的 Default.sublime-theme 和名字带 “Adaptive” 的 Adaptive.sublime-theme 都不含 "class": "file_icon" 规则，所以图标区永远空白。
- 推荐直接换用原生支持的主题：
Material-Theme.sublime-theme、ayu-dark.sublime-theme、Theme - Soda - 若用
Material Theme，用户设置中必须显式启用："material_theme_file_icons": true - 切忌编辑
Packages/Theme - Default/Default.sublime-theme——升级后会被覆盖，且它本就不支持图标
检查 file_icons 是否在 Settings – User 顶层生效
file_icons 是硬开关，但它极其挑剔：必须出现在 Preferences → Settings – User 的 JSON 顶层，不能嵌套在 "theme_settings" 或其他对象里；拼写错一个字母（比如 file_icon）、写成字符串 "true"、或被 "ignored_packages": ["A File Icon"] 屏蔽，都会导致图标静默失效。
- 检查右侧用户设置中是否有这一行：
"file_icons": true（注意是布尔值，不是字符串） - 确认
"ignored_packages"列表里没有"A File Icon"；如有，删掉或整行注释掉 - 改完保存后需重启 Sublime Text 才能加载新设置（缓存不刷新）
重建图标缓存并验证冷门后缀映射
Sublime Text 版本低于 4.4192 时，A File Icon 会静默失效，不报错也不提示；而 .env、.toml、.astro 这类冷门后缀默认不识别，需手动映射到内置图标名上。
- 菜单栏 →
Help → About Sublime Text，右下角看版本号；低于 4.4192 必须升级 - 快捷键
Ctrl+Shift+P，输入A File Icon: Rebuild Icons并回车 - 打开
Preferences → Package Settings → A File Icon → Settings – User，添加：{"extensions": {".env":"settings",".toml":"config",".astro":"html"}}—— 其中"settings"、"config"是插件内置的图标名，不能自定义 - 保存后必须重启 Sublime Text ——
A File Icon: Rebuild Icon Cache命令不加载新extensions映射
最容易被忽略的是：图标渲染依赖主题主动定义图层规则，而不是插件“推”过去就自动显示；哪怕所有配置都对，只要当前主题没声明 "class": "file_icon"，结果就是留白或问号——这不是 bug，是 Sublime 的设计逻辑。
