Sublime Text 文件图标需 A File Icon 插件与支持图标的 UI 主题（如 Adaptive 或 Material-Theme）协同工作；仅安装插件或仅切换主题均无效，必须按顺序安装插件、重启、开启 file_icons 顶层配置、选用兼容主题。
Sublime Text 没有“图标主题”这个独立概念——所谓图标，必须由 A File Icon 插件 + 支持图标的 UI 主题（如 Adaptive.sublime-theme 或 Material-Theme.sublime-theme）协同生效。直接搜“图标主题”安装，90% 会失败或显示为空白/问号。
为什么 Package Control 里搜不到“图标主题”？
因为 Sublime Text 不提供纯图标包（不像 VS Code 的 icon theme marketplace）。所有文件图标都来自字体（Octicons），由 A File Icon 注入 CSS class，再由 UI 主题里的 .sublime-theme 文件定义如何渲染这些 class。你看到的“图标”，其实是主题+插件共同画出来的。
- 搜
FileIcons、Icon Theme、File Icon Pack等关键词，基本是过时、停止维护或 ST4 不兼容的分支（比如作者是kkga的版本） - 真正可用且持续更新的只有
A File Icon（作者必须是sublimelsp） - 它不叫“图标主题”，在 Package Control 列表里就叫
A File Icon，注意大小写和空格，不能少空格写成AFileIcon
正确安装流程：先装插件，再配主题，最后开开关
跳过任何一步，图标都不会出现。顺序不能错：
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package回车 - 等待列表加载完成（几秒），**手动输入
A File Icon（带空格）并回车安装** - 安装完后，**必须关闭并重新打开 Sublime Text**——不重启，CSS 规则不会注入，侧边栏永远不显示图标
- 重启后，打开
Preferences → Settings – User，在顶层 JSON 中添加："file_icons": true（布尔值，不是字符串，不能加引号） - 确认当前 UI 主题支持图标：
Default.sublime-theme和Slush & Poppies.sublime-theme默认不渲染图标；必须切到Adaptive.sublime-theme或已启用图标支持的Material-Theme.sublime-theme
图标还是不显示？重点查这三处
常见失效不是插件没装，而是配置链断在某个环节：
-
"file_icons": true写在了"theme"对象内部，或被套进其他配置块里——它必须是用户设置 JSON 的**顶层字段** - 用了
Material Theme却没加"material_theme_small_file_icons": true，导致图标被压成不可见小方块（尤其 ST4.42xx 版本） - 用户设置里有
"ignored_packages": ["A File Icon"]（可能是旧配置残留），相当于主动禁用 - Linux/macOS 用户没加对应平台开关：
"file_icons_linux": true或"file_icons_osx": true
最稳的验证路径：切回 Adaptive.sublime-theme → 确保 "file_icons": true 在顶层 → 重启 → 运行命令面板里的 AFileIcon: Rebuild Icon Cache。冷门后缀（如 .env、.toml）需要额外映射，但那是下一步的事——先让基础图标跑起来，才谈得上自定义。
