file-icons 插件在 Atom 1.70+ 中失效，因其依赖的 atom.project.onDidChangePaths 等 API 被移除，且图标字体不再被识别；官方已停止维护，推荐迁移到 VS Code 或改用原生 CSS + icon-font 方案。
Atom 的 file-icons 插件本身已停止维护，官方推荐迁移到 VS Code 或其他现代编辑器；如果你仍在 Atom 中使用它，多数图标无法正常显示，尤其在较新 macOS 或 Windows 系统上——根本原因是插件依赖的底层 API（如 Atom 的 atom.project.onDidChangePaths 和样式注入机制）已被弃用或变更。
为什么 file-icons 在 Atom 1.70+ 后几乎失效
Atom 自 1.70 版本起移除了对旧版主题样式钩子的支持，而 file-icons 依赖这些钩子动态注入 CSS 类（如 .icon-file-text）。同时，其图标字体（file-icons.ttf）不再被 Atom 主题系统识别，导致图标回退为默认方块或空白。
- 常见错误现象：
Uncaught TypeError: atom.project.onDidChangePaths is not a function - 即使手动安装成功，文件树中仍显示默认文档图标（灰色纸张）
- 右键 → “Rebuild Package” 无反应，
apm rebuild报错找不到构建目标
临时修复：降级 Atom + 手动启用兼容模式
仅适用于开发环境调试或短期过渡，不建议长期使用。需配合特定版本组合才能让图标勉强可见：
- 必须使用 Atom v1.69.2（最后一个支持旧 API 的稳定版）
- 安装插件后，在
config.cson中强制启用图标渲染："file-icons": "activateOnBoot": true "respectVimMode": false
- 重启 Atom 后，若图标仍不出现，打开开发者工具（
Cmd+Opt+I），检查是否加载了file-icons.css；若未加载，手动在~/.atom/packages/file-icons/styles/下确认存在该文件
真正可行的替代方案：用 icon-font 替代插件
放弃 file-icons 插件本身，改用 Atom 原生支持的 CSS 方式注入图标字体。这绕过插件逻辑，直接控制文件树 DOM 节点样式：
- 下载最新
file-icons图标字体（从 GitHub release 页面获取file-icons.ttf） - 将字体放入
~/.atom/styles/，并在styles.less中声明：@font-face { font-family: 'file-icons'; src: url('file-icons.ttf'); } .tree-view .file.icon:before { font-family: 'file-icons' !important; } - 为常见类型添加伪类规则，例如：
.tree-view .file.icon[data-name$=".js"]:before { content: "\e600"; } .tree-view .file.icon[data-name$=".py"]:before { content: "\e601"; }（具体 Unicode 需查字体 mapping 表）
这套方案不依赖插件生命周期，但需要你手动维护扩展名到图标的映射。真正麻烦的不是加图标，而是 Atom 文件树节点 class 名称不一致（比如 .directory 和 .file 的结构嵌套层级会随 Atom 版本微调），稍有偏差就全盘失效。
