a file icon图标不显示的根本原因是插件（需sublimelsp官方版）、ui主题（如material-theme，非default/adaptive）、file_icons开关（顶层布尔值true且未被ignored_packages屏蔽）三者未协同，任一缺失或配置错误均导致图标留白或问号，且必须重启生效。
Sublime Text 侧边栏图标不显示，90% 不是插件没装，而是 A File Icon、UI 主题、file_icons 开关三者没对齐——它不报错，只留白或问号，改了设置却没反应，大概率是其中一环被绕过了。
如何确认 A File Icon 插件装对了
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（右键托盘 → Exit，或杀掉所有
subl.exe进程），再重启——.sublime-theme只在启动时加载 - 已装错？先执行
Package Control: Remove Package卸载，再重装；别指望“覆盖安装”能修复
为什么换了主题图标还是空白
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 配置为什么总不生效
file_icons 是硬开关，但它极其挑剔：必须出现在 Preferences → Settings – User 的 JSON 顶层，不能嵌套在 "theme_settings" 或其他对象里；拼写错一个字母（比如 file_icon）、写成字符串 "true"、或被 "ignored_packages": ["A File Icon"] 屏蔽，都会导致图标静默失效。
- 检查右侧用户设置中是否有这一行：
"file_icons": true（注意是布尔值，不是字符串） - 确认
"ignored_packages"列表里没有"A File Icon"、"Default"、"Theme - Default"；如有，删掉或整行注释掉 - 改完保存后需重启 Sublime Text 才能加载新设置（缓存不刷新）
如何让 .env、.toml 等文件显示图标
A File Icon 默认只识别约 200 种扩展名，.env、.prettierrc、.astro 这些不会自动匹配图标。解决方式是手动映射到它内置的图标标识符上，不是随便起名。
- 打开
Preferences → Package Settings → A File Icon → Settings – User，添加：{"extensions": {".env":"settings",".toml":"config",".astro":"html"}} - 其中
"settings"、"config"是插件内置的图标名（见其 Default Settings 的icon_names字段），不能写成"dot_env"这种自定义字符串 - 保存后必须重启 Sublime Text——
A File Icon: Rebuild Icon Cache命令不加载新extensions映射
最易被忽略的是：file_icons 必须在 Settings – User 顶层、主题必须真正包含图标 class 渲染规则、插件必须是 sublimelsp 官方版——三者缺一不可，且任何一项改完都必须重启才生效。
