如何在 Windows 上清理 npm、pip、NuGet 和 Gradle 缓存
从开发包缓存中找回空间,并清楚知道自己放弃了什么
包管理器会保留它们下载的所有内容的副本。npm、pip、NuGet 和 Gradle 在你的用户配置文件中各有一个缓存文件夹,在开发机上这些文件夹常常增长到数 GB。由于包可以重新下载,清理它们是安全的;代价是下次安装或构建需要联网,并且耗时更长。
本指南列出了每个缓存所在的位置、清理它的官方命令以及之后的预期情况,并演示如何用 Disk Mop 一次性清理这四个缓存。它还解释了为什么清理工具默认不勾选这些缓存,以及什么时候最好不要去动它们。
要点
- npm、pip、NuGet 和 Gradle 会把下载的每个包保存在缓存中,以加快构建;缓存随时可以重新下载,因此清理是安全的,但之后需要联网。
- 每个工具都有自己的清理命令(npm cache clean --force、pip cache purge、dotnet nuget locals all --clear),而 Gradle 的缓存需要在停止 Gradle 后删除其 caches 文件夹来清理。
- 清理后的第一次构建会更慢,因为所有依赖项都要重新下载;因此不要在临近截止日期或离线时清理。
用 Disk Mop 查看开发缓存占用了多少空间
DiskMop 会自动扫描、识别并安全清理隐藏的缓存、应用残留和系统垃圾。
Windows 上的包管理器缓存
| 工具 | 缓存位置 | 官方清理命令 | 清理之后会发生什么 |
|---|---|---|---|
| npm | %LOCALAPPDATA%\npm-cache(较旧的安装:%APPDATA%\npm-cache) | npm cache clean --force | 下次安装时重新下载包 |
| pip | %LOCALAPPDATA%\pip\Cache | pip cache purge | 需要时重新获取 wheel 和下载内容 |
| NuGet | %LOCALAPPDATA%\NuGet\v3-cache 和 plugins-cache | dotnet nuget locals all --clear | 下次构建时重新还原包 |
| Gradle | %USERPROFILE%\.gradle\caches | 没有命令;停止 Gradle 后删除 caches 文件夹 | 下次构建时重新下载依赖项 |
开发缓存为什么会变得这么大
每次安装依赖项时,工具都会先把下载的压缩包保存到缓存中,再解压到你的项目里。下一个需要同一版本的项目会重用缓存中的副本,而不是重新下载。就速度而言这是一笔划算的交换,但缓存从不遗忘:多年前完成的项目所用的旧版本包仍然留在其中。
Gradle 通常是最大的。它的 caches 文件夹保存着它见过的每个项目和每个版本的已下载依赖项、转换后的构件和构建数据,常常达到数 GB。NuGet 和 pip 增长得更慢,npm 介于两者之间。
这些都不是你的源代码。缓存里只有可以从包注册表重新获取的内容。
npm 和 pip
npm 把缓存放在 %LOCALAPPDATA%\npm-cache;一些较旧的安装使用 %APPDATA%\npm-cache。官方的清理方式是 npm cache clean --force。不带该选项的 npm cache clean 会拒绝运行,因为 npm 认为缓存具有自我修复能力。你的 node_modules 文件夹与此无关,不受影响。
pip 把下载内容和构建好的 wheel 存放在 %LOCALAPPDATA%\pip\Cache。用 pip cache purge 清理,或者先用 pip cache info 和 pip cache list 查看其中有什么。虚拟环境不会被触及,只会删除保存的下载内容。
运行任一命令后,下次安装包时就是一次正常的下载。

DiskMop 如何解决这个问题:概览
在一个屏幕上查看全部磁盘使用情况,立即发现可清理的部分。
NuGet 与 Windows 网页缓存
NuGet 把下载的包保存在 %LOCALAPPDATA%\NuGet\v3-cache,把插件保存在 plugins-cache。要查看全部内容,运行 dotnet nuget locals all --list;要清理,运行 dotnet nuget locals all --clear。用户配置文件下的全局包文件夹是另一回事:它存放已还原项目所使用的包,清理它意味着每个项目都要进行一次完整还原。
Disk Mop 把 NuGet 缓存与 Windows 的 INetCache 文件夹一起归入“NuGet 与网页缓存”。INetCache 存放 Windows 组件缓存的网页内容,会自动重建。
清理之前请关闭 Visual Studio,因为它在运行期间会占用这些文件夹中的文件。
Gradle
Gradle 的缓存位于 %USERPROFILE%\.gradle\caches。没有官方的一行命令可以清空整个缓存;通常的做法是停止 Gradle,然后删除 caches 文件夹中的内容。请先运行 gradle --stop,确保没有守护进程占用文件,并关闭 Android Studio 或 IntelliJ。
下次构建会重新下载每个依赖项,在大型项目中可能需要几分钟,而且 Gradle 会重建它转换后的构件。.gradle 文件夹中的设置(例如 gradle.properties)位于 caches 文件夹之外,只删除该文件夹时不会被移除。
如果你有多个 Android 项目,预计 Gradle 会是本指南中收益最大的一项。
用 Disk Mop 一次性清理
Disk Mop 的“释放空间”页面把 npm 缓存、pip 缓存、NuGet 与网页缓存以及 Gradle 缓存分别列为独立的项目,并显示各自的大小,同时注明你的工具会在需要时重新下载这些包。它们默认不勾选,因为清理它们是有代价的,你应当有意识地选择:下次构建需要联网。
运行扫描,勾选想清理的缓存并确认。Disk Mop 会在删除任何内容之前显示它找到的东西,而且扫描是免费的。请先关闭 IDE 和所有正在运行的构建,以免正在使用的文件被跳过。
如果你不想等待下载,可以只清理很少使用的缓存,保留当前正在做的项目所用的缓存。
常见问题
删除 npm 缓存安全吗?
安全。npm 缓存是 npm 已下载包的存储区。清理它不会改变你的项目或 node_modules 文件夹;npm 只是在你下次安装时重新下载包。npm 自己也为此推荐使用 npm cache clean --force。
清理 Gradle 缓存会破坏我的项目吗?
不会。caches 文件夹中的文件是已下载的依赖项和构建数据,你的源代码并不存放在那里。下次构建会重新下载所需内容,这会花更长时间,并且需要联网。
pip 为什么要保留缓存?
pip 会保存它下载的包和构建好的 wheel,这样在另一个虚拟环境中安装同一个包时速度很快,也无需下载。用 pip cache purge 清理只会删除这份保存的副本。
NuGet 与网页缓存包含浏览器数据吗?
NuGet 与网页缓存涵盖 NuGet 的包缓存以及 Windows 的 INetCache 文件夹,后者是 Windows 组件用于存放网页内容的缓存。它会自行重建,不包含你的文档。
结论
npm、pip、NuGet 和 Gradle 缓存都是随时可以重新下载的包副本,因此清理是安全的,往往能释放数 GB 空间。npm、pip 和 NuGet 使用官方命令,Gradle 则在停止 Gradle 后删除 caches 文件夹。
Disk Mop 在“释放空间”页面列出这四个缓存,显示每一个的大小,并在你做出选择之前保持不勾选。扫描是免费的,因此你可以在决定之前先看看哪个缓存值得清理。
用 Disk Mop 查看开发缓存占用了多少空间
DiskMop 会自动扫描、识别并安全清理隐藏的缓存、应用残留和系统垃圾。