插件安装后不显示，首要检查是否启用；其次确认atom版本与插件兼容性，如file-icons需装v2.1.45兼容版；再验证语法识别、git状态、文件路径等运行条件；最后对含原生模块插件执行apm rebuild。
插件装了但图标/面板/功能完全不出现？先确认是否启用
Atom 默认不会自动启用新装插件，哪怕安装成功也常处于禁用状态。打开 Settings → Packages，搜索插件名（如 file-icons、minimap、linter-ui-default），检查右侧开关是否为蓝色「Enabled」——灰色即未启用，点击开启即可。
特别注意：tree-view 是内置包，若被手动卸载过，需重新运行 apm install tree-view；而 markdown-preview 这类旧插件，装了 markdown-preview-plus 后必须手动禁用前者，否则两者抢控权导致预览空白。
装完没反应，大概率是 Atom 版本和插件不兼容
Atom v1.60+ 移除了旧版 CSS 注入机制，导致多数插件主干分支失效。例如 file-icons 用 apm install file-icons 装出来的包基本不显示图标。
- 必须卸载旧版：
apm uninstall file-icons - 装指定兼容版本：
apm install https://github.com/file-icons/atom/releases/download/v2.1.45/file-icons-2.1.45.tgz - 装完进
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），仅重启不够，必须强制重载样式表
功能存在但 UI 不渲染？检查语法识别和文件状态
很多插件（如 minimap、minimap-git-diff、linter-eslint）依赖正确的 grammar 判断。右下角状态栏显示 Plain text 时，它们基本静默失效。
- 点击右下角语言名 → 手动选对应语法（如
JavaScript、Markdown） -
minimap-git-diff要求文件已被 Git 跟踪且位于仓库根目录下，执行git status和git rev-parse --show-toplevel可验证 -
markdown-preview-plus要求文件已保存、扩展名为小写.md、路径不含中文或空格，否则Ctrl+Shift+M完全无响应
插件显示“Installed”却行为异常？重编译原生模块
Atom 自带独立 Node 环境（v12.x / v14.x），与系统 Node 无关。含原生模块的插件（如 spell-check、term3、linter-eslint）若未用 Atom 内置 Node 编译，就会加载失败——现象是设置页找不到配置项、快捷键无效、控制台报 Cannot find module。
- 关闭所有 Atom 窗口（包括后台进程）
- 运行
apm rebuild（不是npm rebuild） - 若报 zlib 错误，先运行
apm clean再重来 - 验证 Node 版本：
process.versions.node应与 Atom 版本匹配（可在 DevTools Console 中输入）
