file-icons是2026年atom中唯一稳定可用的图标插件，因其纯离线运行、不依赖新版api、内置图标资源、基于扩展名静态匹配，支持.js/.ts/.py等常见语言及.editorconfig等配置文件，安装需atom≥1.60、禁用其他图标插件、勾选hide default icons并设图标为单色16px。
file-icons 是当前（2026 年）Atom 编辑器中唯一稳定、可用且持续轻量维护的图标插件。
其他图标类插件如 atom-material-icons 虽视觉风格统一，但已停止更新，与 Atom 1.60+ 的 Electron 渲染层存在兼容性断裂，启动时易报 require is not defined 或图标不渲染。
file-icons 为什么现在还能用
它不依赖新版 Atom API，所有图标资源内置、离线加载，不走网络请求；图标映射逻辑基于文件扩展名和 .gitattributes 等本地元数据，不调用外部服务或动态 require 模块。
- 支持常见语言：.js、.ts、.py、.rs、.toml、.yml、.dockerfile、.env 等全部识别准确
- 对配置文件友好：
.editorconfig、.prettierrc、.eslintrc.js均有专属图标 - 兼容高 DPI 屏幕：图标缩放无模糊，不依赖 Canvas 渲染
- 无性能拖累：启动时不扫描项目、不监听 fs 事件，仅在树视图渲染时静态匹配
安装 file-icons 的实际注意事项
别用 apm install file-icons-community —— 这个 fork 已在 2025 年底归档，npm registry 中已不可见；官方 file-icons 包仍可装，但必须满足两个前提：
- Atom 版本 ≥ 1.60（最后稳定版），低于此版本可能因 Electron 12→15 升级导致
nativeImage.createEmpty报错 - 禁用所有其它图标类插件（尤其是
atom-material-icons和seti-ui），它们会互相覆盖tree-view的 icon provider 接口 - 安装后需重启 Atom，而非仅重载窗口 —— 图标注册发生在主进程初始化阶段
file-icons 配置里容易被忽略的开关
进入 Settings > Packages > file-icons > Settings 后，这几个选项直接影响可用性：
- Hide default icons：必须勾选，否则系统默认灰色文档图标会和插件图标叠加显示
- Use colored icons：建议关闭（设为单色），彩色图标在深色主题下部分颜色对比度不足，比如 .json 的橙色在 One Dark 中几乎看不清
-
Icon size：设为
16px最稳妥，20px或24px在某些 UI 缩放比例下会导致 tree-view 行高错位 -
Custom icon associations：可手动添加，例如：
"*.svelte": "svelte"，但注意值必须是插件内置图标名（查 icons.json），填错不会报错，只是显示默认图标
file-icons 是目前唯一不出错的选择；如果追求 Material Design 风格或动画效果，得接受它大概率不渲染，或者渲染后点击树节点卡死。
