Sublime Text 侧边栏图标不显示的三大主因是 file_icons 开关未启用、主题不支持图标渲染、或安装了非 sublimelsp 版本的 A File Icon 插件；需确保启用布尔值 "file_icons": true、使用兼容主题（如 Material-Theme）、并安装作者为 sublimelsp 的插件版本。
Sublime Text 侧边栏图标不显示，基本不是插件没装，而是 file_icons 开关没开、主题不支持图标渲染、或插件版本不对——三者缺一，图标就留白。
确认 A File Icon 是 sublimelsp 版本
Package Control 搜索 A File Icon 会列出多个同名包，但只有作者是 sublimelsp 的那个在 ST4 下稳定支持冷门后缀和图标缓存重建。其他分支（如 kkga 或 braver）常出现图标不刷新、.env / .toml 不识别、甚至与 file_icons 配置项冲突的问题。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入Package Control: Install Package - 等待列表加载完成，**手动输入
A File Icon并回车**，在下拉项中核对作者字段是否为sublimelsp - 若已装错，先执行
Package Control: Remove Package卸载，再重装 - 装完必须重启 Sublime Text —— 图标规则只在启动时加载，不重启侧边栏永远不渲染
启用 file_icons 且确保它在 Settings – User 顶层
file_icons 是布尔开关，不是字符串，也不是嵌套字段。它必须直接写在用户设置 JSON 的最外层，否则 Sublime 完全忽略。
- 打开
Preferences → Settings – User - 添加这一行（注意逗号位置，别破坏 JSON 结构）：
"file_icons": true - 不能写成
"file_icons": "true"、"file_icon": true或塞进"theme"对象里 - 检查
file_exclude_patterns是否误加了"*.md"等通配符 —— A File Icon 会跳过所有被排除路径的文件 - 如果用了
.sublime-project，确认里面没覆盖file_icons或theme，项目级设置优先级更高
换用真正支持图标的 UI 主题
默认的 Default.sublime-theme 和 Adaptive.sublime-theme 都不含图标渲染规则，装了插件也白搭。图标实际由主题里的 CSS 类（如 icon-dotfile）控制，不是插件画出来的。
- 推荐直接换主题：
Material-Theme.sublime-theme、ayu-dark.sublime-theme、Theme - Soda - 安装后，在
Settings – User中严格配置："theme": "Material-Theme.sublime-theme"（注意连字符和后缀） - 部分主题需额外开关：Material Theme 要加
"material_theme_file_icons": true；ayu 系列则无需额外配置 - 别指望
Preferences → Settings里有sidebar_icons这种键 —— Sublime 没这个字段
为 .env、.toml 等冷门后缀补图标映射
A File Icon 默认只认常见后缀（.js、.py 等）。像 .env、.toml、.schema 这类，得手动映射到它内置的图标名上，且主题必须支持对应 class 渲染。
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加映射对象，例如：
{"file_icons": {".env": "dotfile", ".toml": "config"}} -
"dotfile"和"config"是插件内置名称，不能自定义为"env_icon" - 保存后图标通常秒变；若无反应，执行命令面板里的
A File Icon: Rebuild Icons - Material Theme 用户务必确认
Settings – User中有"material_theme_file_icons": true，否则它会无视 A File Icon 的映射
最容易被忽略的是：图标只出现在侧边栏，不进标签页；所有图标都来自 Octicons 字体，不是 PNG；icon_theme 字段对 A File Icon 无效，那是给旧版图标插件用的，现在只认 file_icons 开关和主题配合。
