Sublime Text 侧边栏文件图标需同时满足三条件：安装A File Icon插件、启用支持图标的UI主题（如Material Theme）、Settings–User中"theme"和"icon_theme"字段值严格匹配官方包名（如"A File Icon"大小写空格不可错）。
Sublime Text 侧边栏文件图标不会自动出现，必须同时满足三个条件：装对图标插件、配对支持图标的 UI 主题、且 Settings – User 中的 "theme" 和 "icon_theme" 字段值完全匹配已安装包的官方名称——错一个连字符、空格或大小写，图标就静默失效。
为什么装了 A File Icon 还没图标？
常见错误现象："icon_theme": "a file icon"（全小写）、"icon_theme": "AFileIcon"（缺空格）、"icon_theme": "A File Icon.sublime-package"（多加后缀）——全部无效。A File Icon 的正确值就是 "A File Icon"，大小写+空格必须一字不差。
另外，仅装图标插件不够：它本身不改 UI，只提供图标资源；必须搭配 Material Theme、AYU 或 Seti_UI 这类明确声明“support file icons”的 UI 主题，侧边栏才会渲染图标。
实操建议：
- 先确认是否已启用图标：右键侧边栏 → 检查 Enable File Icons 是否勾选（部分版本需手动开启）
- 执行
Package Control: Install Package→ 搜索并安装A File Icon（注意名称里有空格） - 再安装
Material Theme（不是Material Theme UI或其他变体） - 重启 Sublime Text —— 不重启，图标层根本不会加载
Settings – User 配置必须严格匹配包名
打开 Preferences → Settings – User，只编辑右侧用户配置区。两个字段必须同时存在，且值来自 Package Control 安装后的实际包名，不是文件夹名，也不是 GitHub 项目名。
例如用 Material Theme + A File Icon，正确配置是：
{
"theme": "Material-Theme.sublime-theme",
"icon_theme": "A File Icon"
}
常见错误：
-
"theme": "Material Theme"→ 缺连字符和.sublime-theme后缀 -
"icon_theme": "a file icon"→ 大小写敏感，首字母必须大写 - 只写
"icon_theme"没写"theme"→ UI 不变，图标也不显示 - 把
color_scheme路径错粘到theme字段里 → Sublime 忽略该行，无报错但无效
图标不显示的第三种可能：文件类型未被识别
A File Icon 默认只映射常见扩展名（如 .js、.py、.md、package.json）。像 .env、.yml、.tsx 或自定义后缀（如 .api）默认无图标。
解决方法：
- 打开
Preferences → Package Settings → A File Icon → Settings - 在用户设置中添加
file_extensions规则，例如：
"file_extensions": {
"env": "settings",
"yml": "config",
"tsx": "typescript"
}
值必须是 A File Icon 内置的图标类型名（见其 GitHub README），不能随便写。
切换图标主题时别漏掉重建缓存
换图标主题后，旧图标可能仍缓存在内存里，导致新配置不生效。不要反复重启，直接用命令清理：
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）→ 输入 FileIcons: Rebuild → 回车执行。这会强制刷新整个图标索引，比重启更快更可靠。
真正容易被忽略的是：图标主题切换不是“换完即显”，它依赖三重对齐——插件已安装、UI 主题已激活、配置字段值与包名零误差。少一环，侧边栏就回归原始文本列表。
