插件安装后侧边栏无图标，需更换支持图标的UI主题（如Adaptive）并启用AFileIcon图标；Package Control联网失败会导致插件搜不到；图标颜色过淡应通过Customize Theme调整layer0.tint和opacity；.env等文件无图标需在用户设置中手动映射扩展名。
插件装了但侧边栏没图标？不是没装好，是没配对主题
A File Icon 插件本身不直接显示图标，它只提供图标资源；真正渲染图标的，是当前启用的 UI theme。如果你还在用默认的 Default.sublime-theme 或 Slush & Poppies，哪怕插件安装成功，侧边栏也永远空白——这不是 bug，是设计逻辑。
必须做两件事：换一个支持图标的主题（如 Adaptive.sublime-theme、Material-Theme.sublime-theme 或 ayu-mirage.sublime-theme），再确保插件已启用。推荐优先试 Adaptive，它是 Sublime 自带、零依赖、兼容性最强的选择。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入UI Theme→ 选Set UI Theme: Adaptive.sublime-theme - 再输一次
Ctrl+Shift+P，搜AFileIcon: Enable Icons并运行（部分版本会自动触发，但手动点一次最稳） - 无需重启，图标通常立刻出现；若延迟，右键侧边栏 →
Refresh Folders
Package Control 安装失败？先确认控制台能连上 packagecontrol.io
90% 的“搜不到 AFileIcon”问题，根源不是插件名打错，而是 Package Control 根本没加载包列表——它卡在联网阶段。尤其在国内网络环境下，packagecontrol.io 域名常被拦截或 DNS 污染。
验证方法：打开 View → Show Console，输入 import urllib.request; urllib.request.urlopen('https://packagecontrol.io').getcode() 回车。如果报 URLError 或超时，说明网络不通。
- 临时解决：在命令面板中运行
Package Control: Synchronize Packages（需提前配置好代理） - 更稳妥做法：访问 https://www.php.cn/link/befa130dcb31961fa251d61e1e6ba0e1，复制对应系统的安装代码，粘贴进控制台执行
- 别跳过这步直接手动解压 ZIP——手动安装路径稍有偏差（比如解到
Packages/A File Icon-master/而非Packages/A File Icon/），图标就彻底失效
图标颜色太淡或看不清？别改图标文件，改主题层叠规则
A File Icon 默认输出灰阶 SVG 图标，适配多数主题；但如果你用的是高对比深色主题（如 Dracula、Nord 或自定义暗色主题），图标可能发灰、透明度低，甚至完全隐形。
不要去改 Packages/A File Icon/icons/ 下的 SVG 文件——升级插件时会被覆盖。正确做法是通过 Customize Theme 微调图层层叠属性：
- 菜单栏 →
Preferences → Theme → Customize Theme - 在弹出的 JSON 中添加 rule，例如增强饱和度与不透明度：
{ "class": "icon", "layer0.tint": [180, 180, 180], "layer0.opacity": 0.95 } -
layer0.tint控制底色偏移（RGB 数组），layer0.opacity控制整体可见度；数值越接近 1.0，图标越实
.env、.yml 等文件没图标？手动加扩展名映射最直接
A File Icon 内置支持常见类型（.js、.py、.md 等），但像 .env、.yml、.toml 这类现代配置文件，默认可能映射为通用文件图标或不识别。
解决方式不是重装插件，而是编辑插件的用户级配置，添加精准映射：
- 菜单栏 →
Preferences → Package Settings → A File Icon → Settings – User - 填入类似这样的规则：
{ "file_icons": { ".env": "gear", ".yml": "yaml", ".toml": "config" } } - 图标名（如
gear、yaml）必须来自插件内置列表，可查其 GitHub 仓库的icons/目录或文档中的Available Icons表
真正容易被忽略的点是：图标是否生效，不仅取决于扩展名，还依赖文件是否被 Sublime 正确识别为对应语法（比如 Dockerfile 无后缀，需右下角手动设为 source.dockerfile）。否则，即使映射写了，也匹配不上。
