根本原因是插件未启用或主题不兼容，A File Icon 依赖主题文件中的图标映射规则，若当前主题未加载其 rules 则图标不显示；需重启生效、确认 theme 设置、手动注入 rules 或修复路径问题。
为什么装了 A File Icon 插件但文件图标没变
根本原因通常是插件没启用，或主题不兼容。A File Icon 本身不直接渲染图标，它依赖 Sublime Text 的 theme 文件（如 Adaptive.sublime-theme）里定义的图标映射规则。如果当前主题没加载 A File Icon 提供的图标规则，插件就只是“安静地待着”。
- 检查是否已通过 Package Control 安装并重启了 Sublime Text —— 插件安装后必须重启才生效
- 确认当前使用的 UI 主题是 A File Icon 支持的类型：默认只适配
Adaptive和Default主题；用第三方主题（如Origami、ayu）需手动配置theme引用 - 打开
Preferences → Settings – User，确认没有误删或覆盖"theme": "Adaptive.sublime-theme"这行
如何让 A File Icon 在非 Adaptive 主题下工作
多数第三方主题不自带 A File Icon 的图标声明，需要手动补全。本质是把 A File Icon 提供的图标资源“注入”到当前主题的渲染逻辑中。
- 找到 A File Icon 的安装路径：
Packages/A File Icon/A File Icon.sublime-theme（可通过Preferences → Browse Packages…进入） - 复制该文件中的
"rules"数组内容（即所有图标匹配规则） - 打开你正在用的主题文件（比如
Packages/ayu/ayu.sublime-theme），在顶层对象内粘贴到"rules"字段中（注意 JSON 格式合法，末尾逗号、括号闭合） - 保存后重启 Sublime Text —— 不要只刷新，重启才能重载 theme 文件
A File Icon 图标不显示常见错误信息
最典型的报错其实不会弹窗，而是静默失效。但控制台（Ctrl+`）里可能出现这类提示：
error: Unable to open /path/to/Packages/A%20File%20Icon/icons/file_type_json.png
这说明 Sublime 正在找图标文件，但路径解析失败。原因通常是：
- 插件被手动解压到
Packages目录，但文件夹名含空格（如A File Icon）—— Sublime 在 URL 编码时会把空格转成%20，而实际路径是%20还是_容易错乱 - Windows 下路径过长或权限不足，导致 Sublime 无法读取
Packages/A File Icon/icons/下的 PNG 文件 - 使用了压缩包直解方式安装（非 Package Control），且未保留原始文件结构（如缺失
icons/子目录）
不同文件类型图标不生效的参数差异
A File Icon 对文件类型的识别基于 scope（语法作用域）和扩展名双重判断。同一个扩展名可能因语法设置不同而匹配不到图标。
-
.js文件若设置了Plain Text语法，就不会触发javascript图标，得先确保语法是JavaScript或JavaScript (Babel) -
.env默认无图标，需在Preferences → Package Settings → A File Icon → Settings – User中添加自定义规则：{"extensions": ["env"], "icon": "file_type_config"} - 自定义构建系统或语言包（如
Vue Syntax Highlight）可能覆盖.vue的 scope，导致 A File Icon 用默认file_type_text图标而非file_type_vue
图标是否出现，最终取决于 Sublime 能否在当前 view 的 view.scope_name(0) 里匹配到插件预设的 scope 前缀，而不是单纯看后缀名。
