Sublime Text 侧边栏图标不显示是因为 theme、icon_theme 和 file_icons 三者未严格对齐：theme 必须为支持图标的 UI 主题（如 Material-Theme.sublime-theme），icon_theme 值须与插件名完全一致（如 "A File Icon"），且必须显式设置 "file_icons": true，三者缺一不可，且需重启生效。
Sublime Text 侧边栏图标不显示，基本不是插件没装，而是 theme、icon_theme 和 file_icons 三者没对齐——缺一不可，且大小写、后缀、空格全要严丝合缝。
为什么装了 A File Icon 还是方块图标？
因为 A File Icon 本身不渲染图标，它只提供图标定义；真正决定“是否画图标”的是当前 UI 主题是否支持图标渲染，以及用户配置是否开启开关。
-
icon_theme字段必须存在，且值必须与 Package 名完全一致（如"A File Icon"，不是"a file icon"或"AFileIcon"） - 必须同时启用
"file_icons": true—— 这个布尔值控制侧边栏图标的总开关，不加就等于关着门放图标进来 - UI 主题（如
Material-Theme.sublime-theme）内部需声明支持图标渲染；像原生 Default 主题、Soda 等老主题默认不支持，即使配了icon_theme也无效 - 重启 Sublime Text 是硬性步骤：安装完 A File Icon 后不重启，
icon_theme设置不会加载
Settings – User 中必须写的三行关键配置
仅靠菜单点选或命令面板激活主题，大概率漏掉 file_icons 或写错路径。手动编辑 Preferences → Settings – User 最可靠。
-
"theme": "Material-Theme.sublime-theme"—— 注意连字符、.sublime-theme后缀，不能写成Material Theme或Material-Theme -
"icon_theme": "A File Icon"—— 大小写敏感，空格和首字母大写必须与 Package Control 里显示的名称一致 -
"file_icons": true—— 很多人以为装了插件就自动开，其实这是独立开关，必须显式设为true
这三行缺任何一行，图标都会消失。顺序无关，但必须共存于同一 JSON 对象中。
图标不显示冷门扩展名？手动映射文件后缀
A File Icon 默认只识别常见类型（.js、.py、.md 等），像 .env、.yml、.toml 或公司内部自定义后缀（如 .cfgx）需要手动绑定图标名。
- 打开
Preferences → Package Settings → A File Icon → Settings - 在
Settings – User里添加file_extensions数组，例如：{ "file_extensions": { "env": "gear", "yml": "file_text", "toml": "file_text" } } - 图标名必须来自 A File Icon 内置字体集（如
gear、file_text、database），不是任意字符串；可查其 GitHub README 或插件源码里的icons.json
图标颜色不对或发灰？别动配色方案，改 Customize Theme
图标本质是 Octicons 字体字符，颜色由 UI 主题的 CSS 规则控制，不是 color_scheme 管的。想调图标深浅、饱和度，得用 Customize Theme 插件微调。
- 先装
Customize Theme（通过 Package Control 安装） - 执行命令
Customize Theme: Edit Custom Rules - 在生成的
Custom Theme.sublime-settings里加规则，例如：{ "rules": [ { "class": "icon_file", "color": [100, 180, 255] } ] } - RGB 值直接生效，无需重启；但注意：该规则只影响图标，不影响代码区语法高亮
真正容易被忽略的是：图标渲染依赖字体加载顺序和主题 class 命名。如果用了非主流 UI 主题（比如自己魔改的 Spacegray），得确认它是否定义了 icon_file 或 icon_folder class；否则再配 icon_theme 也没用。
