不重启无法真正实时预览图标主题效果,只能通过重建图标缓存(afileicon: rebuild icon cache)并切换支持图标的ui主题(如material-theme.sublime-theme)来逼近效果;需同时满足theme值正确、icon_theme设为"a file icon"、file_icons为true三个条件。

怎么在不重启的情况下快速预览图标主题效果
Sublime Text 的图标主题(如 A File Icon)必须配合支持图标的 UI 主题(如 Material-Theme.sublime-theme)才能渲染,且图标只在启动时加载一次。所以“不重启”只能靠临时切换 + 缓存重建来逼近实时预览效果。
- 先确保已安装
A File Icon(作者必须是sublimelsp)和目标 UI 主题(如Material Theme) - 打开命令面板(
Ctrl+Shift+P/Cmd+Shift+P),输入AFileIcon: Rebuild Icon Cache并执行 —— 这会强制重载图标映射规则,但不会刷新 UI 主题本身 - 再执行
UI: Switch Theme(如果装了 Theme Toggler 插件)或手动改"theme"设置后保存,此时部分主题(如 Material)会热更新侧边栏,图标随之变化;但多数主题仍需重启才完整生效 - 若图标仍空白,立刻切回
Adaptive.sublime-theme(ST4 自带),运行一次AFileIcon: Rebuild Icon Cache:能显示图标说明插件工作正常,问题出在当前主题不支持图标绘制
为什么换了 theme 却看不到图标
不是主题没换成功,而是图标显示依赖三个硬性条件同时满足,缺一不可。
-
"theme"值必须是完整的文件名,例如"Material-Theme.sublime-theme"(注意连字符、大小写、.sublime-theme后缀) -
"icon_theme"必须显式配置为"A File Icon"(大小写敏感,不能是a file icon或AFileIcon) - 用户设置中顶层必须有
"file_icons": true(布尔值,不能是字符串"true",不能嵌套在其他对象里) - 检查
file_exclude_patterns是否误排除了常见扩展名(如"*.md"),A File Icon会跳过所有被排除路径的文件
哪些主题真能显示图标(别试 Default 和 Adaptive)
Sublime 自带的 Default.sublime-theme 和 Adaptive.sublime-theme 完全不含图标绘制规则,哪怕插件和开关全对,图标区也永远留白。
- 真正支持图标的主流主题:
Material-Theme.sublime-theme、ayu-dark.sublime-theme、Theme - Soda、Origami - 部分主题需额外开关:比如
Material Theme要启用小图标需加"material_theme_small_file_icons": true - 验证方法:安装主题后,在命令面板搜
Material Theme: Activate theme(它会自动补全正确配置),比手写更可靠 - 别信 “Seti_UI” 或老版本 “Theme - Flatland”:它们在 ST4 下图标规则大量缺失,尤其对
.ts、.astro、.vue等新扩展名不识别
预览 SVG 图标文件本身要装什么
侧边栏图标和 SVG 文件内容预览是两回事。前者靠 A File Icon + UI 主题,后者需要独立插件。
- 要点击
.svg文件直接在浏览器里看到图形,装SVG Preview插件(通过 Package Control 安装) - 装完后,打开任意
.svg文件,按Ctrl+Shift+P输入SVG Preview: Preview in Browser即可 - 该插件支持热重载:保存 SVG 源码后,浏览器页面自动刷新(无需手动点)
- 注意:
A File Icon只负责让.svg在侧边栏显示一个 SVG 图标,不提供内容预览能力
图标主题的实际效果高度依赖主题自身的 .sublime-theme 文件是否包含图标规则,而这类规则不会报错、也不会提示缺失——它就安静地不显示。最省事的方式是直接用 Material Theme 配 A File Icon,并严格按大小写和后缀写配置,避免在兼容性上空耗时间。











