Sublime显示文件图标_Sublime A File Icon插件【视觉】

file icons 插件无反应主因是sublime版本低于3126或主题不兼容；需用package control安装、重启生效，并在设置中配置文件名映射和文件夹图标，同时更换支持图标的ui主题。

为什么 File Icons 插件装了但没反应

不是插件没装成功，而是 Sublime 默认不启用图标支持。sublime text 3 build 3126+ 和 ST4 才原生支持文件图标渲染，旧版本即使装了 FileIcons 也只显示默认文档图标。

实操建议：

• 先确认版本：Sublime Text → About Sublime Text，低于 3126 就别折腾图标了，换编辑器更省事
• 装插件必须用 Package Control 安装 FileIcons，手动放文件夹无效——它依赖配套的 color scheme 补丁
• 安装后重启 Sublime，不是重载，是彻底关掉再打开，否则 icon theme 不加载
• 如果侧边栏仍是空白图标，检查是否误启用了其他图标插件（比如 Theme - Flatland 自带图标逻辑，会冲突）

如何让 .env 或 docker-compose.yml 显示对应图标

FileIcons 靠文件名和扩展名匹配图标，但像 .env 这种无后缀、docker-compose.yml 这种复合命名，默认不识别——它只认 docker-compose.yaml 或 compose.yaml。

实操建议：

• 在 Preferences → Package Settings → FileIcons → Settings 里加自定义映射：

{   "file_icons": {     ".env": "dotenv",     "docker-compose.yml": "docker"   } }

• 图标名必须是插件内置的 key（如 dotenv、docker、js），不是随便写个名字就生效
• 改完保存设置后，不用重启，但要点击任意文件重新触发 sidebar 刷新（比如点一下别的文件再点回来）
• 注意大小写：Dockerfile 有图标，dockerfile 没有；.gitignore 有，gitignore 没有

FileIcons 和主题（theme）的关系到底是什么

FileIcons 本身不画图标，它只是给 sidebar 的 <span></span> 加 class，比如 icon-file-icon icon-file-yaml；真正决定图标长啥样、颜色、大小的是当前使用的 UI theme。

实操建议：

• 默认的 Adaptive.sublime-theme 对图标支持很弱，几乎不显示——必须换兼容的主题，比如 default Dark.sublime-theme 或社区主题 ayu、Material Theme
• 某些主题（如 Origami）会覆盖 icon class，导致图标消失；这时要进主题包删掉相关 CSS 规则，或改用 FileIcons 提供的 patch 版本
• 图标颜色由 theme 控制，不是插件配色方案；想调颜色？得改 theme 里的 .icon-file-xxx CSS 声明，不是改插件设置

为什么改了设置，node_modules 还是显示文件夹图标

FileIcons 默认隐藏 node_modules、.git 等文件夹的图标，只显示普通文件夹图标（也就是“没图标”）。这不是 bug，是设计：避免侧边栏图标爆炸。

实操建议：

• 想让它显示真实图标（比如 node_modules 显示 npm 图标），要在设置里开开关：

{   "folder_icons": {     "node_modules": "npm"   } }

• 但注意：这仅影响文件夹本身的 icon，不影响里面文件——node_modules/react/package.json 还是靠文件名规则匹配
• 大量 folder icon 会导致 sidebar 渲染变慢，尤其项目根目录下有几十个同级 node_modules 时，卡顿明显
• 别试图给 node_modules/**/* 全局设图标，Sublime 不支持 glob 文件夹路径匹配，只支持一级文件夹名

图标这事，本质是 theme + plugin + 文件名规则 三者对齐。少一个，就只剩小方块。最常被忽略的是 theme 兼容性——很多人调了一小时配置，最后发现只是 theme 拦住了 class 渲染。