A File Icon 默认不处理文件夹图标,需手动启用 colored_folders 并确保主题支持 "folder_icon" 类;Material Theme 需关闭 material_theme_tree_small、设 draw_white_icons 为 false,并启用相关配套选项。

装了 A File Icon 却只看到文件图标、文件夹还是小三角?这不是插件没装好,而是 colored_folders 默认关闭,且多数主题根本不支持该特性。
为什么文件夹没图标,只显示小三角?
A File Icon 插件默认只处理文件图标,对文件夹图标完全不干预。即使你看到 .js、.py 都带颜色,文件夹仍为原始样式,说明 colored_folders 没启用,或当前主题压根不识别它。
-
colored_folders必须显式设为true,且要写在Preferences → Package Settings → A File Icon → Settings – User里,不是全局 Settings - 主题必须在
.sublime-theme文件中定义了"class": "folder_icon"规则,否则即使开了colored_folders也只会留空或显示问号 - 常见“支持图标”的主题如
Material-Theme.sublime-theme、ayu-dark.sublime-theme、AFileIcon Dark.sublime-theme才真正兼容;Adaptive.sublime-theme和旧版Seti_UI不支持 - 保存设置后通常秒级生效,若无效,执行命令面板里的
A File Icon: Rebuild Icons,再重启 Sublime Text
如何确认当前主题是否支持彩色文件夹?
不能只看主题名字是否带“icon”或“material”,得查它实际的渲染规则。
- 打开
Preferences → Theme看当前启用的主题名(比如Material-Theme.sublime-theme) - 用
PackageResourceViewer插件打开该主题文件:Ctrl+Shift+P→PackageResourceViewer: Open Resource→ 选对应主题 → 打开.sublime-theme - 搜索
"class": "folder_icon",如果存在且"layer0"下有"tint"或"texture"定义,才算支持 - 如果搜不到,或只有
"class": "sidebar_folder"这类非标准 class,说明不支持colored_folders
Material Theme 下文件夹图标颜色不对或全灰怎么办?
Material Theme 自身有一套图标逻辑,容易和 A File Icon 冲突,尤其在颜色渲染上。
- 检查用户设置中是否启用了
material_theme_tree_small:这个选项会禁用彩色文件夹,设为false或直接删掉 - 确认
"draw_white_icons": false在 A File Icon 的 Settings – User 中 —— 设为true会导致所有图标变灰 - Material Theme 要求同时开启
"material_theme_big_fileicons": true(针对文件夹图标)和"file_icons_material_theme": true(对接 A File Icon 输出) - Windows 下若 Sublime 安装路径含 OneDrive 或长路径,
Packages/A File Icon/icons/目录可能权限异常,导致 SVG 图标加载失败,表现为图标缺失或变灰
想给 .vscode、src/ 这类目录加专属图标?别试了
Sublime Text 原生机制只按文件类型(extension)或统一 folder 类型渲染图标,不解析路径名。
-
folder_icons配置项只接受布尔值,填字符串或正则会直接被忽略 - 有人尝试用
CustomizeUI注入 CSS 伪类,但在 Sublime Text 4.4+ 已失效,还会引发侧边栏滚动异常 - 真有强需求,只能手动改主题文件:找到
"class": "icon_folder"规则,基于layer0.tint做颜色区分(比如[60, 90, 60]给 src,[90, 60, 60]给 test),但这只是视觉暗示,不是图标替换


















