插件异常八成是缓存污染所致，需清理~/.atom/compile-cache和storage目录、重编译原生模块、配置国内registry并禁用硬件加速。
插件行为异常、报错或不生效，八成是缓存污染了，不是插件坏了，也不是配置写错了。
apm clean 清不干净？先确认它真在清对地方
apm clean 默认只删 ~/.atom/.apm 和 ~/.atom/packages，但很多问题其实卡在 ~/.atom/compile-cache 或 ~/.atom/storage 里。比如启动报 Uncaught Error: Cannot find module，或者 Settings View 打不开，大概率是后者锁死。
- 关掉所有 Atom 窗口（包括后台进程），再运行
apm clean - 手动删掉
~/.atom/compile-cache（macOS/Linux）或%USERPROFILE%\.atom\compile-cache（Windows）——别只删子目录，整个目录一并清 - 若界面卡住或配置不加载，重命名
~/.atom/storage为storage.bak，重启后 Atom 会新建干净的 storage -
apm clean不动项目级node_modules，也跟系统 npm 缓存无关，别指望它解决本地项目依赖问题
装完插件没反应？检查 Node 版本是否匹配
Atom 自带独立 Node（当前主流是 v12.x/v14.x），不走系统 Node。插件含原生模块（如 spell-check、term3）时，必须用 Atom 内置 Node 重新编译，否则“已启用”但功能全失。
- 打开 Atom DevTools（
Ctrl+Shift+I），输入process.versions.node看实际版本 - 确保所有 Atom 窗口已关闭，运行
apm rebuild—— 这才是正确重编译方式 - 别用
npm rebuild，它调的是系统 Node，完全无效 - 如果
apm rebuild报zlib: unexpected end，说明缓存已损坏，先apm clean再来
国内网络下插件安装失败？registry 配置必须单独设
apm 不读取 npm config，改 npm config set registry 完全无效。直连官方源基本超时，表现为 apm install 卡在 “fetching…” 或直接 ENOTFOUND。
- 运行
apm config set registry https://registry.npm.taobao.org/ - 立刻验证：
apm config get registry输出必须是你刚设的地址 - 改完必须跑
apm install --check，看到Checking for native build tools done才算就绪 - 别手动建
.apmrc：Windows 路径是%USERPROFILE%\.atom\.apmrc，macOS/Linux 是~/.atom/.apmrc，内容只能两行且严格无空行、无 BOM、无中文标点
真正难清理的其实是 Electron 渲染进程的 GPU 缓存，它不会被 apm clean 或删 compile-cache 触及；如果以上都做了还是卡顿或白屏，关硬件加速试试。
