a file icon图标不显示本质是插件、ui主题、file_icons开关三者未协同：需安装sublimelsp作者版本，启用支持图标的主题（如material-theme），并在settings–user顶层设"file_icons": true且无ignored_packages屏蔽。
图标主题冲突的本质是插件、主题、配置三者不协同
Sublime Text 文件图标不显示，90% 不是插件没装，而是 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 主题必须原生支持图标渲染，Default 和 Adaptive 默认不支持
A File Icon 本身不画图，只提供图标标识符（如 "config"、"settings"）；真正负责绘制的，是当前 UI 主题里的 .sublime-theme 文件。默认的 Default.sublime-theme 和名字带 “Adaptive” 的 Adaptive.sublime-theme（哪怕它是 ST4 自带）都不含 "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 顶层，且值为布尔 true
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-project，检查项目设置是否覆盖了全局的file_icons或theme，优先级更高 - 改完保存后必须重启 Sublime Text ——
AFileIcon: Rebuild Icon Cache命令不加载新extensions映射
文件图标能否显示，最终取决于三个条件是否同时满足：ST 版本 ≥4.4192、file_icons 开关正确开启、UI 主题真正定义了图标图层。少一个，侧边栏就只剩空框——这不是 bug，是 Sublime 的设计逻辑：它从不猜测你要什么，只严格执行你明确告诉它的配置。
