Sublime Text图标不显示,90%是未开启file_icons开关:必须在Settings–User顶层JSON中写"file_icons": true(布尔值、非嵌套、非字符串、无拼写错误),且需搭配支持图标的主题(如Adaptive)并重启编辑器。

Sublime Text图标不显示,90%是没配file_icons开关
装完A File Icon插件后侧边栏还是文字列表?不是插件没装上,而是file_icons这个布尔开关根本没开。它必须作为顶层字段写进Preferences → Settings – User,不能嵌套在theme或任何其他对象里。
常见错误写法:"theme": {"file_icons": true}(错:嵌套了)"file_icons": "true"(错:字符串不是布尔值)"file_icon": true(错:键名拼错)
正确写法示例(直接加在用户设置 JSON 顶层):"file_icons": true
图标依赖主题支持,Default.sublime-theme默认不渲染
A File Icon本身不画图标,只提供字体和映射规则;真正决定图标是否出现的是当前 UI 主题里的.sublime-theme文件。内置的Default.sublime-theme和Slush & Poppies.sublime-theme默认禁用图标渲染。
必须换用明确支持图标的主题,例如:
- Adaptive.sublime-theme(Sublime 自带,轻量且开箱即用)
- Material-Theme.sublime-theme(需额外加"material_theme_small_file_icons": true)
- ayu.sublime-theme(需手动配置color_scheme路径)
切换方式:
按Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(macOS),输入UI Theme: Set UI Theme,再选目标主题。
A File Icon安装后必须重启,否则 CSS 规则不注入
图标不是靠“启用”按钮生效的,而是靠 Sublime 重载.sublime-theme时注入一组 CSS 规则。这个过程只在启动时触发一次。
所以即使你改完了Settings – User、也切换了主题,只要没重启,侧边栏就永远看不到图标——只会显示问号、空白或纯文字。
重启前建议确认:
- Preferences → Package Settings → A File Icon → Settings能正常打开(说明插件已加载)
- 命令面板中能搜到AFileIcon: Enable Icons(部分版本提供快捷命令)
- 没有残留旧版插件(先执行Package Control: Remove Package卸载再重装)
冷门后缀没图标?不是漏装,是得手动映射
.env、.toml、.tfvars、.astro这类扩展名默认不绑定图标,但不需要重装插件或换主题。
只需在Preferences → Package Settings → A File Icon → Settings – User中添加映射规则,例如:"icon_file_extensions": {"env": "settings", "toml": "config"}
其中右值(如"settings")必须是A File Icon内置的图标名,不是任意字符串。可查其 GitHub README 或源码中的icons/目录确认可用值。
最容易被忽略的一点:所有配置项对大小写、空格、连字符、后缀名都敏感。比如Material-Theme.sublime-theme写成material-theme或Material Theme,图标就彻底消失——而且不会报错,只会静默回退到默认样式。


















