sublime text 侧边栏图标不显示需同时满足：启用支持图标的主题（如material-theme）、在用户设置中显式配置"file_icons": true、安装并正确配置a file icon插件（作者sublimelsp），且三者缺一不可。
图标不显示？先确认 theme 和 file_icons 都配对生效
Sublime Text 侧边栏图标不出现，90% 是因为 theme 和 file_icons 没同时满足条件：前者必须是**真正支持图标的 UI 主题**（如 Material-Theme.sublime-theme），后者必须在 Preferences → Settings – User 的 JSON 顶层显式写成 "file_icons": true。写成 "file_icon": true、"file_icons": "true" 或嵌套在其他对象里都无效。
-
Default.sublime-theme和Adaptive.sublime-theme（哪怕名字带 “Adaptive”）都不含图标规则，切过去图标必然空白 - 重启 Sublime Text 是硬性要求——
.sublime-theme文件只在启动时加载，改完设置不重启等于没改 - 如果用了
.sublime-project，检查里面是否覆盖了theme或file_icons，项目级设置会压过全局设置
装 A File Icon 必须认准 sublimelsp 作者
Package Control 搜索 A File Icon 会列出多个同名包，但只有作者为 sublimelsp 的版本在 ST4 下稳定支持图标映射逻辑。kkga、braver 等分支常有后缀识别缺失、冷门文件类型不渲染、甚至与 file_icons 配置项冲突的问题。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入Package Control: Install Package，等列表加载完后，**手动输入A File Icon并回车**，在下拉项中核对作者字段 - 装错后不要凑合：先执行
Package Control: Remove Package卸载，再重装正确版本 - 装完立刻重启，别指望“热加载”
Material Theme 启用图标需额外加开关
Material Theme 是目前最主流的图标友好主题，但它默认不开启小尺寸文件图标。即使 file_icons 设为 true，侧边栏仍可能只显示文字或留白。
- 在
Settings – User中补上"material_theme_small_file_icons": true - 部分旧版 Material Theme 还需要
"material_theme_disable_fileicons": false，建议直接升级到最新版 - 临时验证是否生效：切回
Adaptive.sublime-theme，运行命令AFileIcon: Rebuild Icon Cache，比重启更快看到变化
文件夹图标和 .env 类文件需单独处理
文件夹图标默认不启用，.env、.gitignore 等点文件也常被忽略——A File Icon 不会自动猜你想要什么，得手动告诉它。
- 启用彩色文件夹：在
Settings – User加"colored_folders": true（前提是主题支持，Material Theme 支持） - 给
.env映射图标：在A File Icon的用户设置（Preferences → Package Settings → A File Icon → Settings）中，加"extensions": {"env": "config"} - 检查
file_exclude_patterns是否误加了"*.md"等通配符——A File Icon 会跳过所有被排除路径的文件
file_icons + colored_folders + 主题专属开关）。少一个环节，侧边栏就退回纯文本时代。别在 Default 主题里调 file_icons，那只是徒劳。
