File Icons 在 Atom v1.60+ 中需安装 v2.1.45 兼容版并手动重载窗口才能显示；自定义图标须在项目根目录 config.cson 中配置，注意 priority、match 正则标志及作用域。
给 Atom 装 File Icons 插件，最让人头疼的莫过于装完没反应。树视图里还是清一色的空白文档图标，Settings 里明明显示插件已启用，可就是不见效果。这问题在 Atom v1.60 及之后的版本里尤其普遍。其实，这并非安装失败，而是新版 Atom 的样式注入机制与旧版插件不兼容导致的。
为什么 apm install file-icons 装完没反应？
直接运行 apm install file-icons 会默认拉取 GitHub 主干的最新版本。但问题是，这个主干分支已经停止维护了，它与当前主流的 Atom 版本（比如 2026 年常用的 v1.60 到 v1.65）存在兼容性问题，核心就是样式表注入失败。所以，你看到的“已启用但无效果”是典型症状。
解决它，需要一套标准操作：
- 安装指定兼容版本：别再用默认命令了。正确的安装指令是：
apm install https://github.com/file-icons/atom/releases/download/v2.1.45/file-icons-2.1.45.tgz。这个 v2.1.45 版本是经过验证的兼容版。 - 检查并启用关键设置：安装完成后，别急着关窗口。进入 Settings → Packages，找到
file-icons，点击进入它的 Settings 页面。务必确认Show icons in tree view（在树视图中显示图标）和Display file names to the right of icons（在图标右侧显示文件名）这两个选项是勾选状态。 - 执行强制重载：如果完成以上两步图标还没出现，这才是关键所在——你需要手动重载 Atom 窗口。执行命令
Application: Reload Window（快捷键通常是Ctrl+Alt+R或Cmd+Alt+R），强制刷新整个编辑器的样式表，图标通常就会乖乖出现了。
如何自定义某类文件的图标或颜色？
插件自带的图标库很全，但总有想自定义的时候，比如给特定的配置文件换个醒目的颜色。这需要通过修改项目根目录下的 config.cson 文件来实现（注意，是项目根目录下的，而不是用户全局的 ~/.atom/config.cson）。
自定义规则的核心是理解几个参数：
- 基本匹配：想为所有
.env文件设置一个齿轮图标和深蓝色？规则可以这么写："Env File": icon: "gear" match: ".env" colour: "dark-blue" - 使用正则表达式：匹配范围可以更精确。例如，想给所有测试文件（以
.test.js结尾）一个专用图标，并提高其匹配优先级："Test JS": icon: "test-js" match: /\.test\.js$/i priority: 2。这里的i标志表示忽略大小写。 - 匹配路径而非仅文件名：如果只想对特定目录下的文件生效，比如仅给
src/test/路径下的.js文件加图标，就需要启用路径匹配：matchPath: true，然后配合正则：match: /src\/test\/.*\.js$/。
规则间的覆盖关系由 priority 数值控制，数值越大，优先级越高。
图标显示错位、重叠或文字被遮挡？
成功显示图标后，偶尔会遇到布局问题：图标和文字挤在一起、相互重叠，或者文件名显示不全。这其实是 Atom 树视图组件自身在计算图标宽度时出了偏差，尤其在开启了“图标右侧显示文件名”选项后更容易触发。
解决办法并不复杂，但需要动一点样式：
- 固定图标宽度：打开你的用户样式文件
~/.atom/styles.less，添加一行规则：.tree-view .icon:before { width: 16px !important; }。这能强制统一图标的显示宽度。 - 补偿文字间距：如果文字仍有被截断的现象，可以再补充一条：
.tree-view .file .name { padding-left: 24px; }，为文件名增加左侧内边距。 - 重要提醒：这些样式修正请务必在用户自定义的
styles.less文件中进行。不要去直接修改packages/file-icons/styles/目录下的原始 CSS 文件，因为插件升级时会覆盖它们，导致你的修改失效。
话说回来，比起安装和布局，更隐蔽的坑其实是自定义规则不生效。如果写了 config.cson 却没看到变化，请按顺序排查：检查是否有 priority 冲突被更高优先级的规则覆盖；确认 match 里的正则表达式是否正确，比如是否忘了加忽略大小写的 i 标志；最后，再次确认规则文件是否放在了当前项目的根目录下，因为插件只认这个位置的配置文件，全局配置对它无效。
