sublime text 侧边栏文件图标不显示,主因是未配置或错误配置 icon_theme 字段;file_icons 仅控制后缀图标开关,图标资源由 icon_theme 指向的主题包提供,且值须与插件名严格一致(大小写、空格、斜杠、后缀均不可错)。

Sublime Text 侧边栏文件图标不显示,90% 是因为只装了图标插件但没配 icon_theme,或配了但值与插件名大小写/空格不一致——它不报错,只静默失效。
为什么开了 "file_icons": true 还没文件图标?
这个设置只控制「文件后缀图标」(比如 .js 右侧的小图标),和文件夹图标、侧边栏整体图标风格完全无关。文件夹图标由 UI 主题(theme)定义,而文件图标样式由 icon_theme 字段指定,二者必须同时存在且匹配。
-
"file_icons": true是 A File Icon 插件的开关,但它本身不提供图标资源,只是渲染器 - 真正提供图标的是
icon_theme指向的主题包,例如"A File Icon"或"Material Theme/Material-Theme.sublime-theme" - 默认主题(
Default.sublime-theme)压根没定义任何图标规则,所以即使开了file_icons也全是空白
icon_theme 必须和插件名完全一致
Sublime 对 icon_theme 的值做严格字符串匹配,大小写、空格、连字符一个都不能错。常见错误包括:
- 写成
"a file icon"→ 正确是"A File Icon" - 写成
"MaterialTheme"或"Material Theme"→ 正确是"Material Theme/Material-Theme.sublime-theme"(注意斜杠和后缀) - 只配了
theme没配icon_theme→ UI 变了,但所有文件图标仍是空白方块 - 配了
icon_theme但插件没装 → Sublime 静默忽略,无提示
确认已安装插件:按 Ctrl+Shift+P 输入 Package Control: List Packages,看列表里是否真有 A File Icon 或对应主题名。
Material Theme 用户请用配套命令激活
Material Theme 自带图标支持,但不会自动写入 icon_theme。手动填容易拼错,最稳方式是运行它的内置命令:
- 按
Ctrl+Shift+P→ 输入Material Theme: Activate theme→ 回车 - 该命令会一次性写入正确的
theme、color_scheme和icon_theme,还启用折叠箭头、状态栏高亮等细节 - 如果命令面板搜不到,说明插件未加载——重启 Sublime Text 后重试
执行后检查 Preferences → Settings – User 是否出现类似这行:"icon_theme": "Material Theme/Material-Theme.sublime-theme"
自定义后缀图标要改 Package Settings,不是用户设置
A File Icon 默认只覆盖主流后缀(.py、.js、.md 等)。像 .env、.yml、.tsx 或公司内部后缀,需单独映射:
- 菜单进入
Preferences → Package Settings → A File Icon → Settings - 在右侧用户设置中添加
file_extensions规则,例如:"file_extensions": {"env": "settings"} - 值必须是 A File Icon 内置的图标类型名(如
"settings"、"config"、"database"),不能随便写 - 改完保存,不用重启,图标会实时更新
注意:这个配置文件和 Settings – User 是两个地方,填错位置无效。











