Sublime Text 侧边栏图标需同时满足三条件：安装 A File Icon 插件、启用支持图标的 UI 主题（如 Adaptive.sublime-theme）、在用户设置中开启 "file_icons": true；图标由 Octicons 字体渲染，仅限侧边栏文件节点显示。
Sublime Text 本身不支持“安装图标主题包”——它没有图标主题 marketplace，也不加载 PNG/SVG 图标资源；所谓图标，全靠 A File Icon 插件 + 支持图标的 UI 主题（如 Adaptive、ayu）协同渲染，所有图标都来自内置的 Octicons 字体。
为什么直接放 .sublime-package 或 ZIP 到 Packages 目录没用
很多人把从 GitHub 下载的 “Material Icon Theme” 或 “Seti_UI” 压缩包解压后扔进 Packages/，发现侧边栏毫无变化。这不是安装失败，而是根本装错了东西：
这些名字带 “Icon Theme” 的项目，大多是为 VS Code 设计的，Sublime 不识别其 JSON 图标映射规则或 SVG 资源目录；它们不是 Sublime 兼容的插件，也不会被加载。
- Sublime 的图标能力只由
A File Icon提供逻辑（文件类型判断、图标名注入） - 真正决定“是否显示图标”和“显示成什么样”的，是当前启用的
UI theme（比如Adaptive.sublime-theme）是否在 CSS 中定义了.icon-xxx类并引用了 Octicons 字体 - 你放进
Packages/的任何非A File Icon插件，只要没注册on_modified或on_activated等事件，对侧边栏图标零影响
离线启用侧边栏图标的三步硬性操作
必须全部满足，缺一不可。跳过任意一步，图标就静默消失：
- 确认已离线装好
Package Control：运行sublime.version()得到4xxx，且Ctrl+Shift+P输入Package Control: List Packages能列出插件（否则A File Icon根本装不上） - 手动安装
A File Icon插件：从 GitHub 下载 ZIP（如 AFileIcon-master.zip），解压后找到含__init__.py的子目录（通常是AFileIcon-master/），重命名为A File Icon（注意空格，大小写必须完全一致），拖入Packages/根目录 - 切换到支持图标的 UI 主题并开启开关：打开
Preferences → Settings – User，确保配置中同时存在这两项："theme": "Adaptive.sublime-theme""file_icons": true
不能嵌套，不能拼错，不能注释掉其中任一
常见失效原因：ignored_packages 和语法作用域陷阱
即使路径、命名、配置全对，图标仍不出现？大概率卡在这两个地方：
-
ignored_packages静默屏蔽：打开Preferences → Settings – User，检查是否有类似"ignored_packages": ["A File Icon"]的字段——如果有，删掉或临时注释，保存后**必须完全退出 Sublime（macOS 右键 Dock Quit，Windows 结束所有subl.exe进程）再重启** - UI 主题未真正生效：
Adaptive是 Sublime 自带主题，但默认不启用；如果当前"theme"值是"Default.sublime-theme"或空字符串，file_icons开关无效。运行sublime.find_resources("Adaptive.sublime-theme")可确认该主题是否存在 - 图标只在侧边栏显示：别在标签页或系统文件管理器里找图标——
A File Icon渲染范围严格限定于侧边栏（sidebar），且仅对文件节点生效，对文件夹无图标（除非主题额外定义）
最常被忽略的一点：图标颜色无法通过 color_scheme 调整，它由 UI 主题的 CSS 中 font-family: "Octicons" 对应的字体文件决定；想改色，得用 Customize Theme 手动 patch 主题 CSS，而不是调配色方案。
