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

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

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

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

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

打开[深度清理](/zh/docs/features/deep-clean)，先运行扫描。如果项目放在其他磁盘，点击扫描按钮旁的下拉箭头，进入**选择磁盘**，把对应磁盘加入扫描范围。

![MangoDisk 深度清理界面，展示清理分类、用户缓存明细与选择控件](https://assets.mangodisk.app/images/screenshots/zh/light-01-deep-cleanup.jpg)

**项目依赖清理会直接删除所选内容，不经过回收站。** 如果曾直接修改过 `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 官方目录说明](https://docs.npmjs.com/cli/v11/configuring-npm/folders/)

所以，清理 npm 缓存后，旧项目的依赖目录仍可能占着空间；只删除某个项目的 `node_modules`，也不会顺便清空 npm 下载缓存。

如果想处理的是下载缓存，可以另外查看 [npm 缓存清理方法](/zh/blog/clean-npm-cache)。使用 pnpm 时，也应把[共享存储的整理](/zh/blog/clear-pnpm-store-cache)与项目依赖清理分开考虑。

## 以后还想运行项目，怎么恢复依赖？

回到项目根目录，也就是放着 `package.json` 的位置，按照项目原来的安装说明恢复依赖。

对于使用 npm、保留了匹配的 `package-lock.json` 的项目，通常可以运行：

```bash
npm ci
```

这会按锁文件重新安装依赖；如果仍有 `node_modules`，它会先将其移除。清单与锁文件不匹配时，命令会报错，不要为了通过安装就删除锁文件。[npm ci 官方说明](https://docs.npmjs.com/cli/v11/commands/npm-ci/)

原来使用 pnpm 或 Yarn 的项目，继续按原来的工具和项目说明安装，避免随意换用 npm 生成另一套锁文件。重新安装还可能需要下载软件包、编译组件，完成后再尝试启动项目。

如果安装失败，先检查项目要求的 Node.js 版本、软件源和账号权限。清理依赖不会补齐这些运行条件，也不能保证所有旧项目都能立即恢复。

## 清完以后，确认空间是否真的腾出来了

完成后先查看 MangoDisk 的清理结果和磁盘可用空间。如果部分目录未能处理，按结果提示检查原因；仍在使用的项目先停下来，确认之后再试。

若依赖目录已经清掉，磁盘仍然很满，可以用[磁盘空间分析](/zh/docs/features/disk-analysis)查看项目目录里还有什么占用，例如保存的视频素材、数据集或导出的文件。这些内容需要分别判断，不能把整个项目文件夹当成依赖一起删除。

[下载 MangoDisk](/zh/download)，先扫描看看旧项目留下了多少依赖。保留以后还想继续做的代码，把暂时用不到、能够重新安装的部分按需清理。 其他相关整理方法可见[开发者清理指南](/zh/blog/topics/developer-cleanup)。
