sublime text侧边栏图标不显示需同时满足三条件:a file icon已安装、当前主题支持图标渲染、settings – user中顶层设"file_icons": true;冷门扩展名需手动映射;material theme下.ts图标异常需更新主题并启用material_theme_file_icons;自定义文件夹图标须用packageresourceviewer修改主题文件。

Sublime Text 侧边栏图标不显示?先确认三件事
图标没出来,90%不是插件装错了,而是三个条件没同时满足:A File Icon已安装、当前主题支持图标渲染、"file_icons": true在 Settings – User 顶层 JSON 中。缺一不可。
-
A File Icon必须通过 Package Control 安装(命令面板输入Package Control: Install Package→ 搜A File Icon);装完别急着重启,先检查Preferences → Package Settings → A File Icon → Settings能否打开 - 默认主题
Default.sublime-theme不渲染图标,必须手动指定一个支持图标的主题,比如"theme": "Adaptive.sublime-theme"或"theme": "Material-Theme.sublime-theme" -
"file_icons": true必须写在 Settings – User 的最外层,不能嵌套在"theme"或其他对象里;如果已有"file_icons": false,删掉它
想让 .env、.toml 显示图标?靠映射,不是换包
这些冷门后缀不会自动亮起图标,A File Icon 内置映射表只覆盖常见类型(.js、.py 等),扩展名得手动挂载到已有的图标名上。
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加
"file_icons"对象,键是带点的扩展名,值是内置图标名(如"dotfile"、"config"、"typescript"),不能拼错或自定义字符串 - 示例:
{ "file_icons": { ".env": "dotfile", ".toml": "config", ".yml": "config" } } - 保存后执行命令面板里的
A File Icon: Rebuild Icons,图标通常秒变;但新增映射项有时需重启才加载
Material Theme 下 .ts 图标还是 JS?别乱配 color_scheme
Material Theme 自带图标映射逻辑,优先级高于 A File Icon 配置,.ts 显示为 JS 往往是因为主题版本旧、配置未开启,或图标资源缺失。
- 确保用的是 2026 年 5 月后发布的
Material Theme(旧版映射不全) - 用户设置中必须显式启用:
"material_theme_file_icons": true - 若仍 fallback 到 JS 图标,可绕过主题,在
A File Icon的 Settings – User 中强制指定:".ts": "typescript" -
color_scheme对图标无影响——它只管文字和编辑区高亮,改它不会让图标变色或出现
直接改 .sublime-theme 文件夹图标?别碰 Default,用 PackageResourceViewer
文件夹图标由主题里的 "class": "icon_folder" 规则控制,默认主题压根没定义这条规则,所以开开关也没用。真要换图标,得改主题文件,但绝不能硬改 Packages/Theme - Default/ 下的原始文件。
- 先装
PackageResourceViewer插件,按Ctrl+Shift+P→ 输入PackageResourceViewer: Open Resource→ 选当前主题(如Adaptive)→ 打开Adaptive.sublime-theme - 搜索
"class": "icon_folder",找到类似结构:{ "class": "icon_folder", "layer0.texture": "Theme - Default/folder.png", "layer0.opacity": 1.0 } - 复制整段,粘贴到
Packages/User/MyFolderIcons.sublime-theme(注意后缀必须是.sublime-theme),把"layer0.texture"改成你自己的 PNG 路径(如"MyFolderIcons/folder-closed.png") - PNG 必须是 16×16 或 32×32,放在同级目录下;写绝对路径或 URL 会失效;改完执行
UI: Reload Theme实时预览
真正麻烦的不是怎么换,而是改错 class 名或 layer0.texture 路径会导致整个侧边栏图标消失——这种错误没法靠重启恢复,得手动删掉自定义主题文件才能回退。











