a file icon插件需与支持图标的ui主题协同工作，图标源自octicons字体而非图片资源；必须通过package control安装正确名称插件、重启编辑器，并在用户设置顶层配置"icon_theme": "a file icon"且启用对应主题开关。
Sublime Text 本身不提供“图标主题”下载入口，所有文件图标都依赖 A File Icon 插件 + 支持图标的 UI 主题协同渲染；直接搜“图标主题”会走错方向，真正要装的是插件，不是皮肤包。
为什么搜不到图标主题？
Sublime Text 没有像 VS Code 那样的图标 marketplace，也不加载 PNG/SVG 图标资源。它的图标全部来自内置的 Octicons 字体，由 A File Icon 插件调用并注入侧边栏——所以你找不到“图标主题下载页”，是因为它根本不存在。
常见错误现象：
- 在 Package Control 里搜
File Icons或icon pack装了错名插件（比如FileIcons，已过时且不兼容 ST4） - 装了
Material Icon Theme这类名字相似的包，但它其实是 VS Code 插件，Sublime 加载失败且无提示 - 以为图标和配色一样能从 Color Scheme 菜单里选，结果右下角状态栏只显示
color_scheme路径，图标毫无反应
正确安装 A File Icon 的三步实操
必须按顺序执行，跳过任意一步图标都不会出现：
- 先确认
Package Control可用：按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package能执行即为就位 - 命令面板中依次执行：
Package Control: Install Package→ 输入A File Icon→ 回车安装（注意大小写和空格，不是a file icon或FileIcon） - 安装后**必须重启 Sublime Text**：缓存不刷新，图标字体不会加载，侧边栏仍显示默认方块
图标不显示？检查这三点配置
即使插件装对、也重启了，图标仍为空白，大概率卡在这三个地方：
-
"icon_theme": "A File Icon"必须写在Preferences → Settings – User中，且值必须与插件名**完全一致**（大小写、空格、连字符都不能差）；写成"a file icon"或"AFileIcon"都会被静默忽略 - 当前启用的 UI 主题必须支持图标渲染：比如
Material Theme、Spacegray、Soda可以；但原生Default或Adaptive主题不支持，图标字段无效 - 某些 UI 主题需额外开启开关：例如
Spacegray要加"spacegray_fileicons": true；Origami则需在插件设置里关掉draw_sidebar_arrows，否则图标被遮挡
图标只作用于侧边栏，不影响标签页或系统文件管理器；冷门扩展名（如 .astro、.svelte）默认无映射，得手动在 A File Icon 设置里加 file_extensions 映射到已有图标名。细节藏得深，但只要路径、大小写、重启三者全对，图标就会稳稳出现。
