插件配置不生效,先确认config.cson中无disabledPackages残留条目;Atom启动时严格读取该数组,插件名若仍在其中则永不加载,需手动删除并重启。

插件配置不生效?先确认 config.cson 里没残留禁用记录
很多“插件看起来启用了但没反应”的问题,根源不在插件本身,而在 config.cson 里还留着旧的 disabledPackages 条目。Atom 启动时会严格读取这个数组,哪怕插件已重装、已启用,只要名字还在里面,它就永远不加载。
实操建议:
- 关闭 Atom,用文本编辑器打开
~/.atom/config.cson(Windows 是%USERPROFILE%\.atom\config.cson) - 搜索插件名(比如
"linter-ui-default"),检查是否出现在core: { disabledPackages: [...] }中 - 删掉整行,保存;如果整个
core区块只剩这一项,建议直接删掉整个core:块,避免缩进错位导致 Atom 启动失败 - 重启 Atom,再进 Settings → Packages 看开关状态是否同步更新
卸载后插件图标还在侧边栏?storage 目录残留了它的 UI 状态
~/.atom/storage 是 LevelDB 数据库,存的是插件运行时的二进制状态——比如面板是否展开、上次折叠的代码块、甚至右键菜单缓存。apm uninstall 不碰这里,所以卸载后你仍可能看到图标残留、点击报错 Cannot find module 'xxx' 或设置页打不开。
实操建议:
- 关掉所有 Atom 进程(macOS 执行
killall Atom,Windows 任务管理器结束所有atom.exe) - 执行
rm -rf ~/.atom/storage/*linter*(把linter换成你的插件名,支持通配符) - 不想猜名字?直接删整个 storage:
rm -rf ~/.atom/storage,重启后 Atom 会重建干净状态库 - 注意:删 storage 不影响
config.cson里的配置,主题、字体等全局设置照常保留
compile-cache 导致插件语法高亮错乱?必须整删,不能只清子目录
~/.atom/compile-cache 存的是 CoffeeScript 和部分 JS 插件编译后的 .js + .map 文件对。一旦 Atom 升级、Node 版本切换或插件更新失败,缓存字节码就和当前环境不匹配,典型现象是:language-xxx 插件不识别后缀、高亮全白、控制台报 Uncaught Error: Cannot find module './main'。
实操建议:
- 别只删
~/.atom/compile-cache/language-javascript这类子目录——缓存文件是跨插件关联生成的,删一半会触发更隐蔽的加载失败 - 直接执行
rm -rf ~/.atom/compile-cache(macOS/Linux)或手动删除%USERPROFILE%\.atom\compile-cache(Windows) - 重启 Atom,它会自动重建全部缓存;首次启动稍慢属正常,后续恢复
- 刚升级 Atom 后遇到问题,顺手也清一下
~/.atom/packages下被标记为inactive的旧包文件夹
apm clean 能解决安装卡住,但它不清理插件运行时数据
apm clean 只清 ~/.atom/.apm 下的 tarball 缓存和 node_modules 解压产物,解决的是 “apm install 卡在 fetching” 或 “装完插件不出现” 这类网络/解压问题。但它完全不管插件自身的配置、UI 状态、编译缓存——这些才是配置“重置”要动的核心。
实操建议:
- 当
apm install xxx卡住或报ETIMEDOUT,先跑apm clean再重试 - 但如果你的目标是让某个插件“回到刚装完的状态”,
apm clean没用,得配合删storage和compile-cache - Windows 用户注意:
apm命令依赖 Node.js 环境,若提示command not found,检查 Atom 安装路径下是否有resources\app\apm\bin,并把它加进系统 PATH
真正难搞的不是删哪个目录,而是删完之后 Atom 启动时静默失败——比如 config.cson 语法错了一格,或 storage 被删了一半,它不会报错,只会卡在空白窗口。这时候得靠终端启动看日志:atom --safe 或 atom --dev,比盲删靠谱得多。

















