Sublime Text 文件图标需插件、主题、语法三者匹配:A File Icon 仅映射后缀到 class(如 config),UI 主题负责渲染;.env 等需手动绑定语法并配置 file_icons 映射;文件夹图标由主题独立控制,与插件无关。

Sublime Text 不支持“不同文件图标主题”,只支持统一图标映射规则
你不能为 .py 用一套图标、.md 换另一套图标主题——A File Icon 插件不提供“按后缀切换图标主题”的能力,它只做一件事:把文件后缀映射到一个预定义的图标 class(如 python、markdown、config),再由当前 UI 主题决定这个 class 渲染成什么图标。主题不变,图标就不变。
所以所谓“设置不同文件图标主题”,本质是两步:先让 A File Icon 正确识别冷门后缀并映射到已有 class;再确保你选的 UI 主题真能画出这些 class 对应的图标。
- 映射靠
file_icons字段(在 Settings – User 顶层) - 渲染靠
.sublime-theme文件里的"class": "icon_python"这类 rule - 两者不匹配 → 图标空白或显示默认问号
如何让 .env、.toml 等文件显示图标
它们默认被识别为 Plain Text,A File Icon 完全忽略——不是插件不干活,是它根本没收到处理请求。
必须手动绑定语法 + 映射图标 class:
- 打开一个
.env文件 → View → Syntax → Open all with current extension as… → ShellScript(这会写入Packages/User/Extensions.sublime-settings) - 同理,
.toml绑定到TOML语法,.dockerfile绑定到Dockerfile - 然后在 Settings – User 中加映射:
{"file_icons": {".env": "dotfile", ".toml": "config"}} - 确认你用的主题(如
Material-Theme.sublime-theme)支持dotfile和config这两个 class
为什么开了 "file_icons": true 还没图标
这是最常卡住的地方:开关只是“允许渲染”,但不保证“有东西可渲染”。以下任一条件不满足,图标就消失:
-
"file_icons": true必须写在 Settings – User 的最外层 JSON,不能嵌套在"theme"或其他对象里 - 当前主题(
"theme": "xxx.sublime-theme")必须包含对应图标的 rule ——Default.sublime-theme和Adaptive.sublime-theme都不支持,别试 -
file_exclude_patterns或项目级设置误排除了目标文件(如写了"*.md",所有 Markdown 就不会触发图标逻辑) - 已装错 A File Icon 版本:只认准作者
sublimelsp,kkga 或 braver 分支在 ST4 下常失效
文件夹图标和文件图标是两套系统
你改了 "file_icons": true,侧边栏里文件名右侧的小图标出来了,但文件夹本身还是空心三角形——因为文件夹图标由主题中 "class": "icon_folder" 规则控制,和 A File Icon 插件完全无关。
想改文件夹图标,只有两个办法:
- 换一个自带
icon_folder规则的主题,比如Material-Theme.sublime-theme或ayu-dark.sublime-theme - 自己编辑
.sublime-theme文件,在rules里加一条:{"class": "icon_folder", "layer0.texture": "Packages/Material Theme/assets/icons/folder.png"} - 注意:路径必须是相对 Packages 的,PNG 尺寸必须是 16×16 或 32×32,写绝对路径或 URL 会静默失败
真正容易被忽略的是:文件夹图标不依赖任何插件,也不响应 file_icons 设置;而文件图标又依赖插件 + 主题 + 语法绑定三者严丝合缝。两边机制完全隔离,混在一起调,只会互相干扰。


















