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+ 并配合新版主题。
- 先通过
Package Control: Remove Package卸载现有 A File Icon - 再执行
Package Control: Install Package，搜索并安装最新版A File Icon（当前稳定版为 v3.13+） - 打开
Preferences → Settings，检查"ignored_packages"数组中是否包含"A File Icon"，如有则删掉 - 确保
Preferences → Settings – User中没有覆盖"file_icons_show_folders"或"file_icons_show_files"为false - 必要时手动在
Packages/User/下新建Default Dark.sublime-theme文件，粘贴官方提供的 minimal theme 配置（见 A File Icon GitHub README），否则 Sublime 4 默认不加载图标样式
图标显示但模糊 / 错位 / 只显示方块怎么办
这是 DPI 缩放或字体渲染导致的视觉问题，不是插件 bug。A File Icon 使用的是 SVG 图标 + 字体 fallback，当系统缩放比例非 100% 或字体缺失时，会退化为 Unicode 符号（如 ），看起来像乱码或方块。
- Windows 用户：右键 Sublime 快捷方式 → 属性 → 兼容性 → 勾选“替代高 DPI 缩放行为”，缩放执行者选“应用程序”
- macOS 用户：确保系统“显示器”设置中缩放为“默认”，而非“缩放”模式；同时检查是否安装了
DejaVu Sans Mono或Source Code Pro等支持 Powerline 符号的字体 - Linux 用户：在
~/.config/sublime-text-4/Packages/User/Preferences.sublime-settings中添加："font_face": "DejaVu Sans Mono"，并确认系统已安装该字体 - 如果仍显示方块，打开命令面板运行
UI: Toggle Console，查看是否有WARNING: unable to find icon for ...日志，说明某类文件的 icon 定义缺失，需检查插件版本或自定义语法关联
