File Icons 在 Atom v1.60+ 中需安装 v2.1.45 兼容版并手动重载窗口才能显示；自定义图标须在项目根目录 config.cson 中配置，注意 priority、match 正则标志及作用域。
File Icons 在 Atom 里不装对版本或不手动重载，基本不会显示图标——不是没装成功，是新版 Atom（v1.60+）和旧版插件 CSS 注入机制不兼容。
为什么 apm install file-icons 装完没反应？
默认 apm install file-icons 拉的是 GitHub 主干最新版，但该分支已停止维护，与当前 Atom（2026 年主流 v1.60–v1.65）存在样式注入失败问题。现象包括：树视图仍是空白文档图标、Settings → Packages 里 file-icons 显示已启用但无效果。
- 必须指定兼容分支安装：
apm install https://github.com/file-icons/atom/releases/download/v2.1.45/file-icons-2.1.45.tgz - 装完不要只点 Restart，要进 Settings → Packages →
file-icons→ Settings，勾选Show icons in tree view和Display file names to the right of icons - 仍不显示？执行
Application: Reload Window（快捷键Ctrl+Alt+R/Cmd+Alt+R），强制重载样式表
如何自定义某类文件的图标或颜色？
修改项目根目录下的 config.cson（不是 ~/.atom/config.cson）即可生效，规则优先级由 priority 控制，数值越大越优先匹配。
- 为
.env文件设专属图标："Env File": icon: "gear" match: ".env" colour: "dark-blue" - 用正则匹配所有测试文件：
"Test JS": icon: "test-js" match: /\.test\.js$/i priority: 2 - 匹配路径而非文件名（如只给
src/test/下的.js加图标）：matchPath: true+match: /src\/test\/.*\.js$/
图标显示错位、重叠或文字被遮挡？
这是 Atom 树视图宽度计算异常的典型表现，尤其在启用了 Display file names to the right of icons 后更明显。根本原因不是插件 bug，而是 Atom 自身对图标宽度的估算偏差。
- 临时修复：在
~/.atom/styles.less中加一行：.tree-view .icon:before { width: 16px !important; } - 若文字仍被截断，补上：
.tree-view .file .name { padding-left: 24px; } - 别动
packages/file-icons/styles/下的原始 CSS——升级后会被覆盖
真正麻烦的不是装不上，而是改了 config.cson 规则却没生效：检查是否漏了 priority 冲突、match 正则没加 i 标志导致大小写不匹配、或者规则写在了全局 config.cson 里却期望只对某项目生效——它只认项目根目录下的那个。
