Sublime Text 侧边栏图标需插件注入CSS类与主题渲染规则双重配合才能显示，仅安装A File Icon插件而未启用支持图标的主题（如Material Theme或AYU）将无效；冷门后缀需在User设置中手动映射内置图标名，修改后须重启项目或执行Rebuild Icons，且不支持自定义SVG或外部图片路径。
Sublime Text 侧边栏图标不能靠设置开关打开，必须同时满足插件注入 + 主题渲染两个条件，缺一不可。
为什么装了 A File Icon 还没图标？
因为图标显示是「数据」和「样式」两层协作的结果：A File Icon 负责给每个文件节点打上 icon-file-js、icon-folder 这类 CSS class；但最终是否渲染出图，取决于当前 .sublime-theme 文件里有没有匹配这些 class 的规则，并指定 layer0.texture 路径。
- 常见错误：只装了 A File Icon，但
"theme"仍设为"Default.sublime-theme"或"Adaptive.sublime-theme"—— 这两个主题默认不定义任何图标规则 - 验证方法：打开
Preferences → Settings – User，确认"theme"值是类似"Material-Theme.sublime-theme"或"ayu-dark.sublime-theme"这种带“图标支持”字样的主题名 - 别信“自动启用”：Material Theme 需手动加
"material_theme_icons_tree_view": true；AYU 需确保没禁用"file_icons": true（它可能被写在 theme 的 settings 里，而不是用户 settings）
A File Icon 的 file_extensions 映射怎么写才生效？
冷门后缀（如 .env、.tf、.astro）不会自动匹配图标，必须手动映射到插件内置的图标名，不是随便填路径或文件名。
- 映射位置：打开
Preferences → Package Settings → A File Icon → Settings – User - 正确写法：
{"file_extensions": {"env": "gear", "tf": "hash", "astro": "html"}}—— 右值必须是插件文档里列出的图标名（如gear、html、folder），拼错就 fallback 成空白文档图标 - 不要改插件自带的
AFileIcon.sublime-settings，它会被更新覆盖；只动User后缀的配置文件 - 改完保存，已打开的侧边栏不会实时刷新，需关闭再重开项目，或执行
A File Icon: Rebuild Icons
换图标 ≠ 换 PNG 文件，Sublime 不支持 SVG 或自定义图片路径
所有“换图标”操作本质都是 class 绑定 + 主题规则匹配。想用自己画的 PNG？行不通——Sublime 渲染图标只认主题包内嵌的 .png 资源，且必须是 16×16 或 32×32 尺寸（高 DPI 下需带 @2x 后缀）。
- 主题内图标路径形如
"layer0.texture": "Theme - Material/folder.png"，这个路径是相对于主题目录的，不能写./icons/folder.png或绝对路径 - 如果硬改
.sublime-theme，改错一个逗号或引号，整个侧边栏可能变空白；建议用PackageResourceViewer提取原主题后另存为新主题包，再局部修改 - 别试
CustomizeUI注入 CSS：Sublime Text 4.4+ 已基本不兼容该方案，.tree_row .icon选择器常被主题规则覆盖，且重启后失效 - 接受现实：截至 2026 年 4 月，Sublime 仍无原生 SVG 图标支持，也无运行时加载外部图标资源的机制
图标突然消失？先查 ignored_packages 和缓存路径
图标失效最常被忽略的两个地方，不是插件坏了，也不是主题错了，而是编辑器自己把关键组件屏蔽了或缓存卡住了。
- 检查
Preferences → Settings – User是否含"ignored_packages": ["A File Icon"]或["Material Theme"]—— 有就删掉，这是 Sublime 的“插件黑名单”，一加就彻底失活 - 缓存路径在
Packages/User/Cache/AFileIcon/，里面一堆.icns和.png是生成的图标资源；若图标错乱或缺失，先运行A File Icon: Purge Icon Cache再Rebuild Icons - 某些公司网络或杀毒软件会拦截
packagecontrol.io，导致 A File Icon 初始化时无法下载字体资源（Octicons.ttf），此时命令面板里A File Icon: Rebuild Icons会卡住或报错，需配代理或手动补全字体
真正麻烦的从来不是“怎么加图标”，而是搞清哪一层出了问题：是插件没注入 class？主题没匹配规则？还是缓存根本没加载？定位清楚再动手，比反复重装快得多。
