Sublime侧边栏图标不显示需满足三个条件：Package Control必须正常联网工作；"file_icons": true须置于Settings–User顶层JSON；当前UI主题必须支持并已启用图标渲染。
Sublime 侧边栏图标不显示？先确认 Package Control 能不能用
绝大多数“装了 A File Icon 却没图标”的问题，根本不在插件本身，而在 Package Control 没真正就位。它不是“装过就算”，而是必须能实时联网拉取包列表。
- 按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS）——必须弹出命令面板；弹不出，说明Package Control没装好或被系统拦截 - 输入
Package Control: Install Package后空白/卡住/报错There are no packages available，大概率是网络问题：公司防火墙、杀毒软件、代理或packagecontrol.io域名被屏蔽 - 检查
Preferences → Package Settings下有没有Package Control项；没有就重装——去 packagecontrol.io 复制对应系统的安装代码，粘贴进View → Show Console执行
装完 A File Icon 为什么还是没图标？三个条件缺一不可
A File Icon 不是“安装即亮”的图标包，它是靠注入数据 + 主题渲染协同工作的。只要漏掉其中一项，图标就彻底隐身。
-
"file_icons": true必须直接写在Preferences → Settings – User的顶层 JSON 中，不能嵌套在"theme"或其他对象里；常见错误是留着默认的"file_icons": false没删 - 当前 UI 主题必须支持图标渲染：
Default.sublime-theme和Slush & Poppies默认关闭图标；Adaptive自带但需手动开启；Material Theme、Ayu、Seti_UI等则需确认已激活对应主题文件（如"theme": "Material-Theme.sublime-theme"） - 插件本身得启用：打开
Preferences → Package Settings → A File Icon → Settings，能正常打开说明已加载；如果点不开，说明被禁用或安装损坏
.env、.toml、.dockerignore 这类文件没图标？不是插件漏了，是你没映射
A File Icon 内置覆盖约 200 种常见扩展名（.js、.py、.md 等），但对冷门后缀默认不识别。这不是 bug，也不用换插件，只需手动映射到已有图标名。
- 打开
Preferences → Package Settings → A File Icon → Settings – User - 添加类似这样的规则：
{ "file_extensions": { "env": "icon_file_type_settings", "toml": "icon_file_type_config", "dockerignore": "icon_file_type_ignore" }} - 图标名必须来自插件内置集合（如
icon_file_type_settings对应齿轮图标），不能瞎写；查可用名可翻看插件默认设置或文档 - 改完保存，不用重启，但建议执行一次
A File Icon: Rebuild Icon Cache确保生效
想调图标颜色或改文件夹样式？别碰主题文件，优先查插件用户设置
很多人一心想改颜色，就去硬改 .sublime-theme 文件，结果主题升级后覆盖、配色错乱、甚至图标消失。其实 A File Icon 提供了更安全、更轻量的控制入口。
- 文件夹图标开关：在
A File Icon → Settings – User里加{ "colored_folders": false }就能关掉彩色文件夹背景 - 图标颜色微调：依赖
Customize UI插件或主题自身支持（如Material Theme有"material_theme_accent_red": true）；纯 A File Icon 不提供颜色配置项 - 别试图往
color_scheme（.tmTheme）里加图标颜色定义——那是给语法高亮用的，对侧边栏图标无效；图标颜色由主题层统一控制
最容易被忽略的是缓存重建和主题激活顺序：装完插件后，必须手动选一次带图标的 .sublime-theme，再执行 A File Icon: Rebuild Icon Cache，最后重启。三步少一步，图标就还在等你点它。
