侧边栏文件图标不显示,主因是file_icons未置于Settings–User顶层或当前theme不支持图标渲染;须换用Material-Theme等兼容主题,确保"file_icons": true为布尔值且重启生效。

侧边栏文件图标不显示,基本不是插件没装,而是 file_icons 没开在正确位置,或当前 theme 根本不支持图标渲染——换主题比调配置快得多。
为什么开了 file_icons 还没图标?
Sublime 的图标渲染完全由 .sublime-theme 文件驱动,file_icons 只是“开关”,不是“画笔”。它只告诉主题“该用哪个图标”,但主题里若没定义 "class": "icon_file_type" 或对应纹理路径,图标照样空白。
-
file_icons必须写在Preferences → Settings – User的最外层 JSON 里,不能嵌套在view_settings、theme_settings或其他对象中 -
"file_icons": "true"(字符串)、"file_icon": true(拼写错误)、"file_icons": true写在项目设置(.sublime-project)里被覆盖,都无效 -
Default.sublime-theme和Adaptive.sublime-theme默认不含图标规则,切过去必然空白;哪怕名字带 “Adaptive”,也不等于支持图标 - 改完必须重启 Sublime Text ——
UI: Reload Theme不刷新图标缓存
怎么选一个真正支持图标的 theme?
别自己硬改 .sublime-theme,优先用成熟主题。Material Theme 是目前最稳的选择,自带完整图标集、小尺寸文件图标开关、彩色文件夹支持,且和 A File Icon 插件协同良好。
- 安装顺序:先装
Package Control→ 再装Material Theme→ 最后装A File Icon(认准作者sublimelsp) - 启用方式:命令面板输入
Material Theme: Activate theme,它会自动写入theme、color_scheme和material_theme_icons_tree_view等关键项 - 验证是否生效:打开含
package.json、.gitignore、README.md的项目,看侧边栏左侧是否有对应图标,不只是盯.js或.py - 如果仍空白,检查
ignored_packages是否误禁了Default或A File Icon
如何让 .env、.yml 这类文件也显示图标?
A File Icon 默认只识别约 200 种扩展名,.env、.prettierrc、.editorconfig 等点文件常被跳过。解决方式不是换插件,而是手动绑定内置图标标识符。
- 路径:
Preferences → Package Settings → A File Icon → Settings – User - 添加
extensions映射块,例如:{"extensions": {".env":"settings",".yml":"config",".prettierrc":"config"}} -
"settings"和"config"是插件内置的图标名(不是路径),完整列表见其 Default Settings 中的icon_names字段 - 保存后必须重启 Sublime Text ——
A File Icon: Rebuild Icon Cache不加载新extensions规则
文件夹图标和彩色文件夹怎么开?
文件夹图标和文件图标是两套机制:file_icons 控制文件后缀小图标,文件夹图标由主题中 "class": "icon_folder" 规则决定,和 A File Icon 插件无关。
- 启用彩色文件夹:
"colored_folders": true(前提是主题支持,Material Theme 支持) - 确保
theme指向的是 Material Theme 或 AYU 等真正定义了icon_folder规则的主题 - 想换文件夹图标 PNG?得改
.sublime-theme文件里的layer0.texture字段,路径必须是包名前缀(如"MyTheme/folder-closed.png"),不是绝对路径或纯文件名 - PNG 尺寸必须是 16×16 或 32×32,否则可能不渲染或拉伸变形
最容易被忽略的一点:项目级设置(.sublime-project)会压过全局设置,哪怕你全局配对了 theme 和 file_icons,只要项目文件里覆盖了其中一项,图标就消失。排查时先关掉项目,用纯全局设置验证。











