Atom 启动卡顿或插件失效，大概率是 ~/.atom/compile-cache 污染所致；该目录存储 CoffeeScript 和部分 JS 插件的编译产物（.js + .map），Node 版本切换、Atom 升级失败或插件更新后易残留不兼容字节码，导致启动慢、语法高亮错乱、控制台报 Cannot find module 错误。
Atom 启动卡顿或插件失效，大概率是 ~/.atom/compile-cache 污染了
这个目录存的是 CoffeeScript 和部分 JS 插件的编译产物（.js + .map 成对生成），Node 版本切换、Atom 升级失败或插件更新后极易残留不兼容字节码。现象包括：启动慢、语法高亮错乱、控制台报 Uncaught Error: Cannot find module。
实操建议：
- 关掉所有 Atom 窗口（macOS/Linux 执行
killall Atom，Windows 任务管理器结束全部atom.exe） - 直接删整个目录：
rm -rf ~/.atom/compile-cache（macOS/Linux）或rd /s /q "%USERPROFILE%\.atom\compile-cache"（Windows） - 别只删子目录或个别文件——删一半会触发更隐蔽的加载失败
- 重启 Atom，它会自动重建缓存
Settings View 打不开、主题/插件开关点不动，先看 ~/.atom/storage
这个目录用 LevelDB 格式存运行时状态：窗口布局、折叠状态、面板尺寸、甚至某些插件的本地设置。进程异常退出容易卡在写入中间态，导致下次启动拒绝加载。
实操建议：
- 关掉 Atom 后，重命名该目录：
mv ~/.atom/storage ~/.atom/storage.bak - 再启动 Atom，它会新建干净的
storage，大部分配置仍保留在config.cson里 - 别手动编辑或删
storage文件——它是二进制格式，改坏就彻底无法恢复界面状态 - 如果只是某个插件配置丢了，优先去
config.cson里确认对应 key 是否还在
apm clean 能解决“插件更新了但行为没变”的问题，但它不管项目级 node_modules
apm clean 清的是 ~/.atom/.apm 下的缓存：npm tarball 和解压后的 node_modules。它不影响你在当前项目里 npm install 的依赖。
实操建议：
- 执行
apm clean后，首次装插件会变慢（要重新下载），但能解决“明明更新了插件却还是旧行为” - 插件报
Cannot resolve 'fs-extra'类错误，大概率是.apm里某层依赖被破坏，apm clean比手动删更安全 - 不需要定期跑——只在装插件失败、或多个插件突然集体
require报错时才用
彻底卸载或重装前，必须手动清理这四个目录
GUI 卸载或 Windows 控制面板只删主程序，%USERPROFILE%\.atom\（Windows）或 ~/.atom/（macOS/Linux）完全不动。残留会干扰重装、新用户配置，甚至让同步的 config.cson 失效。
必须清理的四个路径：
-
~/.atom/packages/：插件源码目录，apm uninstall可能漏掉 symlink 或依赖包 -
~/.atom/storage/：LevelDB 运行时状态库，损坏后 Settings View 直接打不开 -
~/.atom/.apm/：APM 缓存，不清理可能导致新装插件行为异常 -
~/.atom/compile-cache/：JS 编译缓存，删一半比不删更危险
Windows 用户别信“控制面板卸载就完事”——注册表里根本没记录这个路径，%USERPROFILE%\.atom\ 得自己进资源管理器删。
