sublime text 侧边栏文件图标不显示需同时满足：安装 sublimelsp 版 a file icon、用户设置中正确配置 "file_icons": true、"theme" 和 "icon_theme" 三项、使用支持图标的主题（如 material-theme）、手动映射冷门后缀，并彻底重启软件。
Sublime Text 侧边栏文件图标不显示，不是插件没装，而是 theme、file_icons 开关、icon_theme 三者没对齐——缺一不可，且全部必须重启后才生效。
确认 A File Icon 是 sublimelsp 官方版
Package Control 搜索 A File Icon 会列出多个同名包，但只有作者为 sublimelsp 的版本在 ST4.4192+ 下稳定支持图标映射和冷门后缀扩展。其他分支（如 kkga 版）常出现 .env 不识别、extensions 配置静默失效等问题。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入Package Control: Install Package - 等列表加载完，**手动输入
A File Icon并回车**，在下拉项中核对作者字段是否为sublimelsp - 若已装错：先执行
Package Control: Remove Package卸载，再重装
Settings – User 必须同时配齐三项
file_icons 开关、theme、icon_theme 必须全部写在用户设置顶层 JSON 中，顺序无关，但拼写、大小写、后缀一个都不能错。写错任何一项，Sublime 都会静默忽略，不报错也不提示。
-
"file_icons": true—— 必须是布尔值true，不能是字符串"true"，也不能嵌套在"theme_settings"里 -
"theme": "Material-Theme.sublime-theme"—— 注意连字符和.sublime-theme后缀，"Material Theme"或"Material-Theme"均无效 -
"icon_theme": "A File Icon"—— 大小写敏感，"a file icon"或"AFileIcon"都不生效
改完必须完全退出 Sublime Text（不是关闭窗口，是彻底退出进程），再重新启动。仅靠 AFileIcon: Rebuild Icon Cache 命令无法加载新 extensions 映射。
让 .env、.toml 等文件显示图标要手动映射
A File Icon 默认只识别约 200 种扩展名，.env、.prettierrc、.astro 等不会自动匹配。你不能随便起名，必须映射到它内置的图标标识符上（见其 Default Settings 的 icon_names 字段）。
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加
"extensions"对象，例如：{"extensions": {".env": "settings", ".toml": "config", ".astro": "html"}} -
"settings"、"config"是插件预定义的图标名，写成"dot_env"或"env_file"无效
主题必须真正支持图标渲染
A File Icon 只负责“告诉主题该画什么”，真正画图标的，是当前 UI 主题里的 .sublime-theme 文件。很多主题（包括 Default.sublime-theme 和名字带 Adaptive 的）根本不定义 "class": "file_icon" 规则，所以即使插件和配置全对，图标区也留白。
- 推荐直接用
Material-Theme.sublime-theme（需额外确认"material_theme_file_icons": true已启用） - 或
ayu-dark.sublime-theme、Theme - Soda，它们原生支持图标占位 - 切忌编辑
Packages/Theme - Default/Default.sublime-theme—— 升级后会被覆盖，且它本身就不含图标规则
最容易被忽略的是：项目级设置（.sublime-project）可能覆盖全局 "file_icons" 或 "theme"，导致部分文件夹下图标消失。检查右下角状态栏是否显示 “Project Settings” 提示。
