如何清理旧项目的 node_modules,释放磁盘空间
旧项目的 node_modules 占了不少空间?用 MangoDisk 集中查看项目依赖的路径和容量,选择暂时不用的目录清理,保留源码与锁文件,并了解以后如何重新安装依赖。
以前做过的网站、试用过的示例项目,放着不用后,里面的 node_modules 仍会占用空间。确认项目暂时不用、依赖还能重新安装,就可以删除这部分依赖目录,保留项目源码。 以后再次运行项目时,需要先装回依赖。
MangoDisk 支持扫描项目依赖和构建产物,把找到的目录及容量集中列出。你可以查看它们属于哪个项目,再选择要清理的部分,不用逐个打开旧项目查大小。
用 MangoDisk 找到旧项目的依赖目录
打开深度清理,先运行扫描。如果项目放在其他磁盘,点击扫描按钮旁的下拉箭头,进入选择磁盘,把对应磁盘加入扫描范围。

项目依赖清理会直接删除所选内容,不经过回收站。 如果曾直接修改过 node_modules 里的文件,先备份这些改动;重新安装软件包不会还原你的手工修改。
扫描完成后,按下面的顺序检查:
- 在底部选择方式中选暂不选择,先清空已有勾选,方便只处理这次打算整理的内容。
- 找到项目构建产物分类,展开 Node.js 构建产物。
- 对照明细中的路径和容量,找到暂时不用的项目。名称相近时,打开所在文件夹确认,不要只看项目名或大小。
- 只勾选确认要移除的
node_modules目录,保留还在使用的项目。这个分类还可能列出框架构建缓存,不需要因为属于同一分类就全部选中。 - 停止相关项目的开发服务、构建和依赖安装任务,核对所选路径与预计释放空间,再点击清理并确认。
MangoDisk 的作用是把分散的依赖目录找出来,方便比较和选择。哪个项目可以暂时收起来,仍由你决定;一个目录很大,并不代表它已经没用。
哪些项目适合先清理?
优先从已经结束、暂时只想保留源码的项目开始,例如看完的教程示例、不再维护的旧网站,或试过之后搁置的原型。
正在开发、近期需要演示,或接下来要离线使用的项目,可以先保留。依赖删除后,项目的运行和构建通常要等重新安装完成,清理它们反而会打断接下来的工作。
清理前,确认这些内容都留在项目里:
- 源码与素材:自己写的代码、页面、图片和其他项目文件。
- 依赖清单与锁文件:
package.json,以及项目使用的package-lock.json、pnpm-lock.yaml或yarn.lock。 - 运行配置与本地数据:例如
.env、本地数据库,以及没有备份的上传文件。
依赖来自私有仓库、公司内部源,或使用了特别旧的运行环境时,先确认之后仍能安装。拿不准的项目先留着,不必为了腾空间一次清完。
删除 node_modules,会清掉 npm 缓存吗?
不会把两者一并清掉。node_modules 是项目已经安装的依赖,npm 下载缓存则用于复用下载过的软件包数据,它们通常分开存放。npm 官方目录说明
所以,清理 npm 缓存后,旧项目的依赖目录仍可能占着空间;只删除某个项目的 node_modules,也不会顺便清空 npm 下载缓存。
如果想处理的是下载缓存,可以另外查看 npm 缓存清理方法。使用 pnpm 时,也应把共享存储的整理与项目依赖清理分开考虑。
以后还想运行项目,怎么恢复依赖?
回到项目根目录,也就是放着 package.json 的位置,按照项目原来的安装说明恢复依赖。
对于使用 npm、保留了匹配的 package-lock.json 的项目,通常可以运行:
npm ci
这会按锁文件重新安装依赖;如果仍有 node_modules,它会先将其移除。清单与锁文件不匹配时,命令会报错,不要为了通过安装就删除锁文件。npm ci 官方说明
原来使用 pnpm 或 Yarn 的项目,继续按原来的工具和项目说明安装,避免随意换用 npm 生成另一套锁文件。重新安装还可能需要下载软件包、编译组件,完成后再尝试启动项目。
如果安装失败,先检查项目要求的 Node.js 版本、软件源和账号权限。清理依赖不会补齐这些运行条件,也不能保证所有旧项目都能立即恢复。
清完以后,确认空间是否真的腾出来了
完成后先查看 MangoDisk 的清理结果和磁盘可用空间。如果部分目录未能处理,按结果提示检查原因;仍在使用的项目先停下来,确认之后再试。
若依赖目录已经清掉,磁盘仍然很满,可以用磁盘空间分析查看项目目录里还有什么占用,例如保存的视频素材、数据集或导出的文件。这些内容需要分别判断,不能把整个项目文件夹当成依赖一起删除。
下载 MangoDisk,先扫描看看旧项目留下了多少依赖。保留以后还想继续做的代码,把暂时用不到、能够重新安装的部分按需清理。 其他相关整理方法可见开发者清理指南。