atom缓存必须手动清理四个目录:~/.atom/.apm/(apm依赖缓存)、~/.atom/compile-cache/(js编译缓存)、~/.atom/storage/(运行时状态数据库)、~/.atom/packages/(残留插件及符号链接),且需先关闭atom进程并同步清理config.cson中相关配置。

Atom 的缓存不清理,重装或换配置时大概率出问题——GUI 卸载或 apm uninstall 都不会动它。
哪些目录算“缓存”,必须手动删
Atom 没有统一的“缓存清理”按钮,所谓缓存分散在四个关键路径下,各自作用不同,但都可能拖慢启动、干扰插件行为、甚至让 Settings View 打不开:
-
~/.atom/.apm/:APM 下载的 tarball、解压后的node_modules缓存。不清理会导致新装插件用旧版依赖,apm install报错或静默失败 -
~/.atom/compile-cache/:JS 文件编译生成的.js和.map文件。删一半会触发加载异常(比如报Error: Cannot find module './main.js'),必须整删 -
~/.atom/storage/:LevelDB 格式的状态数据库,存着面板位置、折叠状态、上次打开的 tab 等。损坏后常见现象是主题切换无效、linter-ui-default 启动报Failed to load package -
~/.atom/packages/本身不是缓存,但apm uninstall后残留 symlink 或未清空的子目录(如node_modules)也会被误认为“已卸载”,实际仍在参与加载
执行前必须关掉 Atom 进程
很多人删完 ~/.atom/storage/ 重启 Atom,发现 Settings View 白屏或无限转圈——因为 Atom 在运行时会锁住 LevelDB 文件。哪怕只留一个后台窗口,rm -rf ~/.atom/storage/ 也可能删不干净或写入失败。
安全做法:
- macOS:先
killall Atom,再确认 Activity Monitor 里没Atom Helper进程 - Windows:任务管理器里结束所有
atom.exe和atom-node.exe - Linux:
pkill -f atom,再ls ~/.atom/storage/确认目录为空
删完别急着重启,先检查 config.cson
缓存目录清空了,但 ~/.atom/config.cson 里还可能留着已删插件的痕迹:
-
core: { disabledPackages: ["linter-ui-default"] }—— 插件已删,这行还在,Atom 启动时仍尝试加载,报Cannot find module 'linter-ui-default' -
'linter-eslint': { ... }—— 插件配置块残留,可能引发设置页崩溃
建议用文本编辑器打开 ~/.atom/config.cson(确保 Atom 已完全退出),搜索插件名,整块删掉对应段落。不要只删 disabledPackages 里的名字,配置块也要清。
Windows 用户注意路径和权限
Windows 下路径是 %USERPROFILE%\.atom\,不是 ~/.atom;且杀毒软件常拦截对 .apm 或 compile-cache 的删除操作,导致 rm -rf 类命令失败。
更稳妥的做法:
- 用 PowerShell 运行:
Remove-Item "$env:USERPROFILE\.atom\.apm" -Recurse -Force - 若提示“访问被拒绝”,右键 Atom 卸载程序 → “以管理员身份运行”,再手动进资源管理器删整个
.atom目录 - 删完别忘了清注册表项:
HKEY_CURRENT_USER\Software\GitHub\Atom(非必须,但彻底)
真正“干净”的缓存清理,不是删几个文件夹,而是删完之后 Atom 能像第一次启动那样加载 Settings View、不报任何模块缺失错误、不卡在“Loading packages…”。最容易被忽略的是 storage 和 config.cson 的联动——删了前者却不碰后者,等于只擦玻璃不擦窗框。











