图标不显示需同时启用图标插件（如A File Icon）和兼容UI主题（如Material-Theme.sublime-theme），仅装其一无效；检查Settings – User中theme配置及file_icons_*开关是否冲突，刷新侧边栏或重建图标缓存可解决多数问题。
图标不显示？先确认插件和主题是否真正生效
Sublime 侧边栏文件图标不是开箱即用的功能，它依赖两个独立组件：一个负责“提供图标映射”的插件（如 A File Icon），另一个负责“把图标渲染出来”的 UI 主题（如 Material-Theme.sublime-theme）。只装其中一个，图标必然不出现。
- 常见错误现象：插件已安装、命令面板里能搜到
A File Icon: Rebuild Icons，但侧边栏还是只有小圆点或纯文字——大概率是当前"theme"设置没指向支持图标的主题 - 检查方法：打开
Preferences → Settings – User，确认存在类似"theme": "Material-Theme.sublime-theme"或"theme": "ayu-dark.sublime-theme"的配置项；若只有"theme": "Default.sublime-theme"或"theme": "Adaptive.sublime-theme"，默认是不显示图标的 - 别信“已安装=已启用”：某些主题（如 Flatland）需额外加
"file_icons_flatland": true；macOS 用户常漏掉"file_icons_osx": true；这些开关一旦缺失，图标就静默失效
换图标 ≠ 换插件，而是换主题或重配映射规则
所谓“换图标”，实际分两种路径：一种是整体切换视觉风格（比如从深色 Material 换成浅色 Ayu），另一种是微调个别文件类型的图标（比如让 .env 显示齿轮而不是文档）。前者靠换 .sublime-theme 文件，后者靠改 A File Icon 的用户配置。
- 换主题最快：按
Ctrl+Shift+P→ 输入UI: Select Theme→ 选带 “Material”、“Ayu” 或 “AFileIcon” 字样的主题。注意名称必须含.sublime-theme后缀，Ayu Mirage和Ayu Light是两套完全不同的图标集 - 改单个后缀图标：打开
Preferences → Package Settings → A File Icon → Settings – User，添加"file_extensions": {"env": "gear", "toml": "config"}——右值"gear"必须来自插件内置图标名（查 GitHub README 的 icon names 表），不能填随便的文件名或路径 - 别手动删
ignored_packages：如果发现A File Icon突然失效，先检查Settings – User里有没有"ignored_packages": ["A File Icon"]这种配置，有就删掉
重启不是万能的，但“刷新侧边栏”经常被忽略
很多用户装完插件、改完设置就关掉 Sublime 再打开，结果图标还是没变——其实多数时候根本不用重启编辑器，只要让侧边栏重新加载图标缓存即可。
- 最轻量操作：右键点击侧边栏空白处 → 选择
Refresh Folders；或者折叠/展开侧边栏（快捷键Ctrl+K, Ctrl+B） - 缓存出问题时才需要重建：命令面板输入
A File Icon: Purge Icon Cache→ 回车 → 再运行A File Icon: Rebuild Icons。这个过程会联网下载字体资源，失败时看状态栏提示（比如 “Failed to download icons”） - 别在
Settings – User里写"file_icons": false：这是硬性关闭开关，哪怕插件装得再全、主题选得再对，这行一存在图标就彻底消失。删掉它比重装插件还管用
自定义文件夹图标？小心 colored_folders 的副作用
很多人想给 node_modules 或 src 文件夹加专属颜色或图标，但 A File Icon 并不支持按文件夹名匹配——它只认扩展名和文件类型 scope。真正能控制文件夹图标的，是少数几个主题自己的选项。
-
Material Theme支持："material_theme_small_file_icons": true+"material_theme_bold_tab_title": true，但文件夹图标仍是统一风格，无法为特定文件夹指定图标 -
A File Icon提供的"colored_folders"只是给所有文件夹加背景色块，并非换图标；设为false后文件夹变回默认灰色，但不会影响文件图标 - 真要差异化标识文件夹，目前唯一靠谱做法是用
SidebarEnhancements插件配合自定义 CSS（需启用Enable Custom CSS），但这已超出图标插件范畴，且 Sublime 4 对自定义 CSS 支持不稳定
最容易被卡住的地方，其实是主题和插件的“双重绑定”：你换了 Ayu 主题，但 A File Icon 的配置里还留着 "file_icons_soda": true，这种错位会导致图标部分缺失。与其反复试错，不如先清空 Settings – User 里所有 file_icons_* 开关，只保留 "theme" 和 "color_scheme"，再一步步加回来。
