如何为Sublime Text侧边栏添加图标并安装FileIcons插件？

本文共计1030个文字，预计阅读时间需要5分钟。

Sublime Text侧边栏默认不显示文件图标，安装FileIcons插件后也不代表图标能立即出现——它只是伪美化效果。要使其生效，必须搭配支持图标的UI主题（如Material-Theme.sublime-theme）。否则，图标只会出现在文件名后，且颜色单一，不随文件类型变化。

为什么装了 FileIcons 还是没图标？

FileIcons 和 A File Icon 是两个不同插件：FileIcons 不注入 CSS 类，也不依赖主题图标规则，而是直接在文件名右侧插入固定尺寸的 PNG 图标；它轻量、启动快，但扩展性差、图标少、不支持冷门后缀映射。常见失效原因：

• 当前主题禁用了右侧图标区域（如某些精简版 Adaptive 变体会隐藏 .tree_row .icon）
• FileIcons 自带的图标资源未加载成功，控制台（Ctrl+`）里可能出现 FileIcons: failed to load icons
• 你正在用高 DPI 显示器但插件没提供 @2x 图标，导致图标模糊或不渲染
• 其他插件（如 CustomizeUI 或 Origami）覆盖了 .tree_row 的 padding/margin，把右侧图标挤出可视区

FileIcons 安装后必须做的三件事

不同于 A File Icon，FileIcons 不需要 Rebuild Icons 命令，但有三个硬性动作缺一不可：

• 确认 Preferences → Settings – User 中没有 "ignored_packages": ["FileIcons"] —— 有就删掉
• 确保 "theme": "xxx.sublime-theme" 指向的是一个**明确支持右侧图标的主题**，例如 Material-Theme.sublime-theme 或 ayu-dark.sublime-theme；Default.sublime-theme 和 Slush & Poppies 默认不预留右侧空间
• 重启 Sublime Text —— FileIcons 的图标注入发生在初始化阶段，热重载主题或改设置都不触发重绘

怎么让 .env、.dockerignore 这类文件也显示图标？

FileIcons 不提供 file_extensions 映射机制，它只认内置的约 80 种扩展名（见其 GitHub README 的 icons.json）。想让冷门后缀显示图标，只有两个办法：

• 手动编辑 Packages/FileIcons/icons.json，在 "extensions" 数组里加一行："env": "gear" —— 但下次插件更新会被覆盖
• 更稳妥的做法：卸载 FileIcons，改用 A File Icon，然后在 Packages/User/AFileIcon.sublime-settings 里写：{"file_extensions": {"env": "gear", "dockerignore": "docker"}}
• 注意右值（如 gear）必须是插件已声明的图标名，拼错就 fallback 成空白方块

FileIcons 和 A File Icon 到底该选谁？

如果你只需要快速加几个基础图标（.js、.py、.md），且不用深色/浅色自动切换、不关心文件夹颜色、不打算长期维护配置，FileIcons 启动快、无依赖、不卡顿。但只要涉及以下任一需求，就该换 A File Icon：

• 要让 .astro 显示 HTML 图标，或 .tf 显示云朵图标
• 希望文件夹按语言分类着色（colored_folders）
• 用的是公司内网或离线环境，无法自动下载 SVG 缓存
• 主题经常切换，不想每次换主题都重新调图标位置

真正容易被忽略的点是：图标是否可见，从来不是插件单方面决定的；它是插件注入时机、主题预留空间、Sublime 渲染管线三者对齐的结果。哪怕所有配置都写对了，只要某次启动时 ST 加载顺序异常，图标就可能消失——这时别急着重装，先试 UI: Reload Theme。