图标不显示需先确保Package Control正常：命令面板可调出且Install Package能加载列表；再切换至Adaptive等支持图标主题，并在用户设置中正确配置"file_icons": true；最后按需映射冷门后缀或用Customize Theme微调样式。
图标不显示？先确认 Package Control 能用
90% 的安装失败，其实根本没走到插件这步——卡在 Package Control 没装好或被拦截。按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）必须能弹出命令面板，否则 AFileIcon 压根装不上。
- 打开
Preferences → Package Settings，看有没有Package Control项；没有就重装：去官网复制对应系统的安装代码，粘贴进View → Show Console执行 - 如果命令面板能调出，但
Package Control: Install Package提示 “There are no packages available”，大概率是公司网络、杀毒软件或系统代理屏蔽了packagecontrol.io - 别跳过验证：装完后重启 Sublime，再试一次
Ctrl+Shift+P输入Package Control: Install Package，看到列表滚动加载才算真正就位
装了 AFileIcon 却没图标？主题和开关缺一不可
AFileIcon 不是“图标包”，它只是往侧边栏注入图标数据的桥梁；真正决定图标的，是当前 UI 主题是否支持渲染 + 用户设置里是否开了开关。用默认的 Default.sublime-theme 或 Slush & Poppies，装了也白装。
- 必须切换到支持图标的主题，比如 Sublime 自带的
Adaptive.sublime-theme（推荐最轻量），或第三方如Material-Theme.sublime-theme -
Preferences → Settings – User中必须有顶层配置项："file_icons": true；不能写在"theme"对象里，也不能拼错成"file_icon"或"file_icons_enabled" - 部分主题需额外兼容开关，例如用
Material Theme要加"file_icons_material_theme": true；用Soda则要加"file_icons_soda": true
.env、.toml 这类文件没图标？手动映射比换插件快
AFileIcon 内置覆盖约 200 种常见扩展名（.js、.py、.md 等），但对 .env、.toml、.conf 等冷门后缀默认不识别——这不是 bug，是设计如此。不用找所谓“更全的图标包”，直接配映射就行。
- 打开
Preferences → Package Settings → AFileIcon → Settings – User - 添加规则，例如：
"icon_file_extensions": {"env": "settings", "toml": "config"} - 图标名（如
settings、config）需来自插件内置资源，可查Packages/AFileIcon/icons/目录下的文件名（不含后缀） - 正则匹配更灵活：用
"patterns"数组支持通配，比如{"pattern": "\.env$", "icon": "settings"}只匹配结尾为 .env 的文件
图标颜色/大小不对？别改插件源码，用 Customize Theme 微调
图标由 Octicons 字体渲染，不是 PNG/SVG 图片，所以不能像 VS Code 那样直接换图标包。颜色、尺寸、间距等视觉细节，得通过 Sublime 的 Customize Theme 功能调整，而不是修改插件目录或用户设置里的 JSON。
- 按
Ctrl+Shift+P输入Customize Theme，会打开当前主题的自定义文件 - 在里面加规则，例如调整图标大小：
{"class": "icon", "font.size": 14} - 改颜色要用
"color"属性，但注意：很多主题把图标颜色绑定在layer0.tint上，直接设 color 可能无效，得查主题源码里 icon 相关 class 的实际样式链 - 所有改动保存即生效，无需重启；但改错可能让整个侧边栏图标消失——建议每次只改一行，验证后再继续
Default 主题。真要调得顺，三件事得同时到位：Package Control 可用、主题选对、"file_icons": true 在正确位置。 
