a file icon 图标不显示的主因是插件未正确安装启用、主题不支持图标或后缀映射错误；须认准 sublimelsp 作者包，重启 st，开启 file_icons 及平台开关，搭配 material-theme 等支持图标的主题，并严格按格式手动映射冷门后缀。
确认 A File Icon 是否装对且启用
图标不显示，八成是插件没装对或根本没生效。Package Control 里搜 A File Icon 会列出多个同名包，必须认准作者是 sublimelsp 的那个——kkga 或 braver 分支在 ST4 下常有冷门后缀识别失败、file_icons 配置项被忽略等问题。
装完立刻重启 Sublime Text：.sublime-theme 文件只在启动时加载，不重启图标区域永远留白或显示问号。
检查用户设置（Preferences → Settings – User）是否含这行且位于 JSON 顶层：
"file_icons": true
写成 "file_icons": "true"、漏掉引号、拼成 file_icon 或嵌套在 "theme" 对象里，全无效。
还要确认没把它加进 ignored_packages 列表里。
换一个真正支持图标的主题
A File Icon 本身不画图标，它只负责给文件打 class 标签（比如 icon-config），真正在侧边栏把图标“画出来”的，是 UI 主题里的 .sublime-theme 文件。
默认的 Default.sublime-theme 和 Adaptive.sublime-theme（哪怕名字带 “Adaptive”）都不含图标规则，所以即使插件装对、开关开了，图标区也留白。
推荐直接换主题：
-
Material-Theme.sublime-theme：自带完整图标集，需额外加"material_theme_small_file_icons": true -
ayu-dark.sublime-theme或ayu-light.sublime-theme：开箱即用，无需额外配置 -
Theme - Soda：老但稳定，部分版本需手动开启兼容开关
临时验证是否是主题问题？切回 Adaptive.sublime-theme，再运行命令 AFileIcon: Rebuild Icon Cache，比重启更快见效。
为 .env、.toml 等冷门后缀手动映射图标
A File Icon 默认不认 .env、.toml、.tfvars 这类扩展名，得手动告诉它“这个后缀该用哪个图标”。但格式极严格：
- 键名必须小写、无点、纯扩展名：写
"env"，别写".env"或"ENV" - 值必须是插件内置图标名：
"config"、"settings"、"dotfile"、"html"等，拼错就 fallback 成空白文档图标，且不报错 - 映射必须加在用户设置顶层的
"file_icons"对象里，不能嵌套
例如让 .env 显示齿轮图标、.toml 显示配置图标：
"file_icons": {
"env": "settings",
"toml": "config"
}
注意：如果用了 Material Theme 原生图标支持，就别装 A File Icon ——二者同时启用可能冲突导致图标错位或消失。
Linux/macOS 用户别漏掉平台开关
Linux 下必须显式开启图标支持，否则侧边栏图标完全不渲染：
"file_icons_linux": true
macOS 同理：
"file_icons_osx": true
这两个配置项和 "file_icons": true 是并列关系，缺一不可。Windows 用户不用加。
另外检查 file_exclude_patterns 或 folder_exclude_patterns 是否误加了 "*.md" 这类通配符——A File Icon 会跳过所有被排除路径的文件，不渲染图标。
自定义图标这事，核心就三块：插件得对、主题得画、映射得准。少一块，图标就断在半路；映射写错一个字母，.env 就永远是空白页图标——它不会提醒你，只会沉默地 fallback。
