sublime text默认不支持侧边栏图标,因adaptive/default主题未定义icon_folder等css规则;必须安装a file icon插件、切换至afileicon dark/light等兼容主题、启用file_icons:true,并运行rebuild icons命令。

Sublime Text 默认图标主题无法恢复,是因为它压根没有图标主题——Adaptive 和 Default 主题都不支持文件图标渲染。想让侧边栏显示图标,必须换用第三方图标友好型主题,并配对 A File Icon 插件;所谓“恢复默认图标”本身是个伪命题。
为什么 Adaptive / Default 主题不显示图标
A File Icon 插件只负责给 DOM 元素添加 icon-js、icon-folder 这类 class,但真正画图标的,是 UI 主题里的 .sublime-theme 文件。而 Sublime Text 4 自带的 Adaptive.sublime-theme 和 Default.sublime-theme 根本没定义这些 class 的样式规则,所以图标区域永远空白或显示问号。
这不是 bug,是设计如此:Sublime 默认不渲染任何文件图标。
- 别指望通过修改
Preferences.sublime-settings加"sidebar_icons": true—— 这个键根本不存在 - 也别去改
ignored_packages试图“启用 Default 主题”——它本来就在运行,只是不画图标 - 重装 Sublime 或删
Packages/User子目录,图标照样不出现,因为问题不在用户配置层
正确启用图标要三步配齐
图标显示依赖插件、主题、开关三者协同生效,缺一不可:
- 装对插件:
Package Control: Install Package→ 手动输入A File Icon→ 确认作者是sublimelsp(不是 kkga 或其他分支) - 选对主题:必须切换至原生支持图标的主题,如
Material-Theme.sublime-theme、ayu-dark.sublime-theme或Theme - Soda;不能用Adaptive凑合 - 开对开关:在
Preferences → Settings – User中,顶层必须有"file_icons": true(布尔值,不能是字符串"true",也不能嵌套在"theme"对象里)
装完插件或换完主题后,务必重启 Sublime Text —— .sublime-theme 只在启动时加载。
A File Icon: Rebuild Icons 必须手动触发
插件安装或升级后,SVG 图标资源不会自动下载和注入。不执行这步,class 虽然挂上了,但对应 SVG 文件根本不存在,渲染引擎拿不出图形。
- 快捷键:
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS) - 输入
A File Icon: Rebuild Icons并回车 - 看控制台(
Ctrl+`)是否有进度提示;若卡住或报AFileIcon: failed to inject icon classes,大概率是网络受限或 Sublime Text 版本低于 4.4192 - ST4 用户请确认插件已是 v3.0+(旧版 v2.x 在 ST4 下 class 注入机制不全)
自定义扩展名映射(如 .astro 显示 HTML 图标)也要在这之后才生效——改完 Settings – User 里的 "file_extensions",必须再跑一次 A File Icon: Rebuild Icons。
彻底重置图标环境时最易漏的三件事
删配置目录重装看似简单,但实际最容易卡在这三个环节:
-
ignored_packages里误加了"Default"或"Theme - Default"—— 这会跳过加载原生主题资源,导致所有图标 class 失去渲染入口 - 同步账号没登出:
subl --sync-logout没执行,重启后云端配置直接覆盖本地重置结果 - 后台进程没杀干净:Windows 任务管理器里残留
sublime_text.exe,macOS 活动监视器里没强制退出Sublime Text,Linux 没运行pkill -f "sublime_text"—— 它会在你删完重启时悄悄把旧状态刷回来
路径本身也容易错:Linux 是 ~/.config/sublime-text-4(短横线,小写),不是 sublimetext4 或 sublime_text_4;macOS 是 ~/Library/Application Support/Sublime Text(不带版本号),不是 Sublime Text 4。











