A File Icon 侧边栏图标不显示的最常见原因是插件未启用、主题不支持或 Sublime 4 版本兼容问题；需确认插件已启用、选用支持该插件的主题（如 ayu 或 Material Theme）、升级至 v3.0+ 并检查 ignored_packages 设置。
为什么装了 A File Icon 插件侧边栏图标还是没变
最常见原因是插件安装后未启用或主题冲突。A File Icon 本身不直接替换图标，而是为文件类型添加 CSS 类（如 .icon-file-type-js），最终是否显示图标取决于当前 UI 主题是否支持这些类。默认的 Adaptive 或 Default 主题不包含对应样式，所以即使插件已安装并运行，图标也不会出现。
- 打开
Preferences → Package Settings → A File Icon → Settings – User，确认内容至少为空对象{}（非空配置可能禁用图标） - 检查是否误启用了其他图标插件（如
FileIcons），两者会冲突 - 重启 Sublime 后按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入UI: Select Theme，选一个明确支持 A File Icon 的主题，例如ayu、Material Theme或官方推荐的Default Dark.sublime-theme（需手动启用）
如何确认 A File Icon 已正确加载
插件是否生效不能只看“已安装”，得看它有没有把 class 注入到侧边栏 DOM 中。Sublime 的侧边栏是基于自定义 HTML/CSS 渲染的，A File Icon 通过修改 side_bar.sublime-menu 和注入 CSS 类起作用。
- 右键任意文件 →
Copy File Path，然后在命令面板中运行View Package File，输入A File Icon/side_bar.sublime-menu，如果能打开该文件，说明插件资源已就位 - 打开任意文件，按下
Ctrl+Shift+P输入Developer: Show Scope Name，将光标放在侧边栏文件名上，若看到类似entity.name.filename.js或带icon-前缀的 scope，说明 A File Icon 已成功挂载 class - 如果 scope 里只有
text.plain或meta.file这类泛用 scope，大概率是插件未激活，或被ignored_packages列表屏蔽了
Sublime 4 下 A File Icon 不显示图标的典型修复步骤
Sublime Text 4 对插件生命周期和 UI 渲染做了调整，部分旧版 A File Icon（v2.x）无法自动适配，必须升级到 v3.0+ 并配合新版主题。
