file-icons 插件无需配置即生效，依赖 Atom 的 grammar 识别而非文件扩展名；若图标不显示，先检查右下角 grammar 是否正确（如 JavaScript），再排查路径、缓存、插件冲突及 Windows 中文路径兼容性问题。
file-icons 插件根本不需要“配置”就能用
装上就生效，前提是 Atom 已正确识别文件类型。它靠 grammar（语法高亮规则）判断后缀，不是简单看扩展名。比如一个 .js 文件如果被 Atom 错判成 Plain text，图标就不会显示 JS 图标——这是最常被误认为“插件没起作用”的原因。
- 检查右下角状态栏：确认当前文件的 grammar 显示为
JavaScript，而不是Plain text或Auto - 手动切换 grammar：右键编辑区 →
Grammar→ 选对应语言（如JavaScript） - 若长期错判，可能是文件头部缺失或内容太短，可加
// @ts-check或"use strict";帮助识别
图标不更新？先查 file-icons 的匹配优先级
file-icons 不是按扩展名硬匹配，而是按 grammar → scope → path 规则逐层 fallback。比如一个 .config.js 文件，如果 grammar 是 JavaScript，它会优先用 JS 图标；但如果路径含 /webpack/，可能被 webpack.config.js 专用规则捕获，显示 webpack 图标。
- 想强制指定图标？在
config.cson里加自定义映射（不推荐，易冲突）："file-icons": "associations": ".myext": "archive"
- 禁用某类图标：设置里关掉
Hide icons for unsupported files，否则未识别 grammar 的文件会显示空白 - 图标缓存问题：Atom 重启后仍不刷新？删掉
~/.atom/storage/file-icons目录再试
和其他插件冲突时图标消失的典型表现
file-icons 和 tree-view 深度耦合，但和某些主题（如 one-dark-ui）、文件管理插件（如 project-manager）存在 CSS 覆盖问题。最常见现象是：文件名左侧有空隙，但图标透明或极小。
- 检查开发者工具（
Cmd+Alt+I）：看图标元素是否被display: none或opacity: 0覆盖 - 临时禁用所有插件，只留
file-icons+ 默认主题，确认是否恢复 - 冲突多发于
custom-file-icons或icon-fonts类插件，二者不能共存
Windows 上中文路径导致图标不显示
旧版 file-icons（v2.1.x 及之前）在 Windows 中文路径下会因 URI 编码失败跳过图标渲染，错误日志里会出现 ENOENT 或 Invalid URI。
- 升级到
v2.2.0+：已在atom://file-icons/lib/service/icon-node.js中修复路径 decode 逻辑 - 验证方法：新建一个纯英文路径项目（如
C:\test\index.js），对比图标是否正常 - 若仍异常，检查 Atom 是否以管理员权限运行——某些杀软会拦截 icon 文件读取
