必须同时满足插件装对（sublimelsp版）、主题支持图标（如Material-Theme）、用户设置顶层写入"file_icons": true三个条件，缺一则侧边栏图标空白或显示问号。
Sublime Text 默认不显示侧边栏文件图标，启用图标主题不是开个开关就行，而是必须同时满足三个硬性条件：插件装对、主题支持、配置写准——缺一不可，否则图标区域永远是空白或问号。
确认 A File Icon 插件是否装对（别被 Package Control 搜出来的同名包坑了）
A File Icon 在 Package Control 里有多个作者版本，只有 sublimelsp 维护的才是 ST4 官方兼容版。kkga、braver 等分支在最新版中常出现图标映射缺失、冷门后缀（如 .env、.toml）不识别、甚至与 "file_icons": true 配置项冲突的问题。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入Package Control: Install Package - 等列表加载完，**手动输入
A File Icon并回车**，在下拉项中核对作者字段是否为sublimelsp - 安装完成后必须重启 Sublime Text ——
.sublime-theme文件只在启动时加载，不重启图标不会渲染 - 如果已装错，先执行
Package Control: Remove Package卸载，再重装
选对并启用真正支持图标的 UI 主题
A File Icon 本身不画图标，它只提供文件后缀到 CSS class 的映射逻辑；真正负责绘制图标的，是 UI 主题里的 .sublime-theme 文件。默认的 Default.sublime-theme 和 Adaptive.sublime-theme 均不含图标规则，即使插件和配置全对，图标区也留白。
- 推荐直接换主题：
Material-Theme.sublime-theme、ayu-dark.sublime-theme、Theme - Soda都原生支持图标渲染 - 安装主题后，用命令面板执行
Material Theme: Activate theme（或其他对应主题的激活命令），它会自动写入"theme"和相关图标开关 - 部分主题需额外开启图标开关，例如 Material Theme 要在用户设置中加
"material_theme_small_file_icons": true - 别指望在设置里搜
"sidebar_icons"—— Sublime 没这个配置项
检查用户设置中 "file_icons": true 是否写对位置
这个配置项是图标开关的唯一生效点，但它必须出现在 Preferences → Settings – User 的 JSON 顶层，不能嵌套在 "theme" 或其他对象里，且值必须是布尔型 true。
- 正确写法：
"file_icons": true（顶层、布尔值、无引号包裹true） - 错误写法：
"file_icons": "true"（字符串）、"file_icon": true（拼写错误）、"file_icons": true写在"theme"对象内部 - 检查
file_exclude_patterns或folder_exclude_patterns是否误加了"*.md"这类通配符 —— A File Icon 会跳过所有被排除路径的文件 - 如果你用了
.sublime-project，确认里面没覆盖"theme"或"file_icons"，否则项目级设置会压过全局设置
临时验证与冷门后缀图标补全
如果图标仍不显示，可快速验证是否是主题或缓存问题；而像 .env、.toml 这类文件，默认不会显示图标，需要手动映射。
- 切回
Adaptive.sublime-theme（ST4 自带），再运行命令AFileIcon: Rebuild Icon Cache，比重启更快见效 - 要让
.env显示图标，在Settings – User中添加："file_icons": {".env": "dotfile", ".toml": "config"}，但前提是所用主题支持dotfile和config这两个 class 的渲染 - 文件夹图标需启用
colored_folders（Material Theme 等主题提供该选项），且主题本身得有对应 rule 定义 - 优先换主题而非改主题 —— 手动编辑
.sublime-theme容易因语法错误导致整个 UI 异常
最常被忽略的一点：图标是否渲染，完全取决于 .sublime-theme 文件里有没有对应 class 的 layer0.texture 或 icon 定义。A File Icon 只管“叫名字”，主题才管“画出来”。装对插件、选对主题、配对开关，三者缺一，就只剩问号。
