MangoDisk 标志

当前浏览器版本过旧

MangoDisk 网站需要较新的浏览器才能正确显示。请升级 Microsoft Edge,或使用其他现代浏览器打开。

你仍然可以直接下载 MangoDisk:

升级 Microsoft Edge

如何清理旧项目的 node_modules,释放磁盘空间

旧项目的 node_modules 占了不少空间?用 MangoDisk 集中查看项目依赖的路径和容量,选择暂时不用的目录清理,保留源码与锁文件,并了解以后如何重新安装依赖。

发布于 2026/11/16作者: Harry

以前做过的网站、试用过的示例项目,放着不用后,里面的 node_modules 仍会占用空间。确认项目暂时不用、依赖还能重新安装,就可以删除这部分依赖目录,保留项目源码。 以后再次运行项目时,需要先装回依赖。

MangoDisk 支持扫描项目依赖和构建产物,把找到的目录及容量集中列出。你可以查看它们属于哪个项目,再选择要清理的部分,不用逐个打开旧项目查大小。

用 MangoDisk 找到旧项目的依赖目录

打开深度清理,先运行扫描。如果项目放在其他磁盘,点击扫描按钮旁的下拉箭头,进入选择磁盘,把对应磁盘加入扫描范围。

MangoDisk 深度清理界面,展示清理分类、用户缓存明细与选择控件

项目依赖清理会直接删除所选内容,不经过回收站。 如果曾直接修改过 node_modules 里的文件,先备份这些改动;重新安装软件包不会还原你的手工修改。

扫描完成后,按下面的顺序检查:

  1. 在底部选择方式中选暂不选择,先清空已有勾选,方便只处理这次打算整理的内容。
  2. 找到项目构建产物分类,展开 Node.js 构建产物。
  3. 对照明细中的路径和容量,找到暂时不用的项目。名称相近时,打开所在文件夹确认,不要只看项目名或大小。
  4. 只勾选确认要移除的 node_modules 目录,保留还在使用的项目。这个分类还可能列出框架构建缓存,不需要因为属于同一分类就全部选中。
  5. 停止相关项目的开发服务、构建和依赖安装任务,核对所选路径与预计释放空间,再点击清理并确认。

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,先扫描看看旧项目留下了多少依赖。保留以后还想继续做的代码,把暂时用不到、能够重新安装的部分按需清理。 其他相关整理方法可见开发者清理指南。