**结论:不再开发的项目里的 node_modules 可以放心删。**只要项目里还留着 package.json 和 lockfile,以后重新打开时执行一次 npm install / pnpm install 就能恢复。
用 Cursor、Claude Code、Codex 做 Vibe Coding 久了,硬盘里很容易不知不觉躺着几十上百个测试项目。我们在一台开发用 Mac 上实测(仅统计个人文件夹内,不含 ~/Library):共找到 304 个 node_modules,合计占用 66.3 GB;另外还有 8 个 .venv(5.1 GB)和 7 个 .build(2.9 GB)。每台电脑情况差别很大,但先量一下自己的机器往往会有惊喜。
注意:
du统计的是目录总占用,不等于直接删掉就能立刻腾出这么多空间——例如使用pnpm的项目和公共 store 之间存在硬链接,下面第 2 节会详细说明。
1. 一行只读命令:先看清你的 Mac 上有多少 node_modules
不要上来就 rm -rf。先用 -prune 跳过嵌套的 node_modules 和 ~/Library,只列出体积最大的前 25 个:
find ~ \( -path ~/Library -o -path ~/.Trash -o -name .git \) -prune -o \
-type d -name node_modules -prune -exec du -sh {} + 2>/dev/null \
| sort -h | tail -25
如果只想看某个工作目录(比如 ~/Repos)里超过 60 天没动过的项目:
find ~/Repos -name node_modules -type d -prune -mtime +60 -exec du -sh {} + 2>/dev/null | sort -h
2. 哪些情况不要盲目删?
- 正在跑服务的项目:开着 dev server 或后台构建的项目,删了会立刻报错。
- 被 Git 跟踪的
node_modules:极少数老项目会把依赖提交进仓库,动手前最好确认git ls-files node_modules | head为空。 - 使用
pnpm的项目:pnpm通过硬链接把~/Library/pnpm里的包映射到各个项目的node_modules。只删单个项目的目录不一定立刻释放空间,需要配合pnpm store prune。 - 即将离线工作:如果马上要在飞机或无网环境改某个项目,记得先把它的依赖留着。
3. 安全清理的两种手动方式
在确认目标文件夹后,比起直接 rm -rf,更推荐使用交互式工具或先移入废纸篓:
# 方式 A:进入项目总目录,用 npkill 按最后修改时间交互选择清理
cd ~/Repos
npx npkill
# 方式 B:如果你主要用 pnpm,记得清理未被引用的 store 缓存
pnpm store prune
4. 如果不想敲命令,也可以用 CleanBit 可视化筛选
我是 CleanBit 的开发者,这是一款上架在 Mac App Store、运行在 macOS 沙盒里的磁盘清理工具(支持 macOS 15+,不要 root、不装后台 helper):
- 项目产物模块会找出
node_modules、target、.build、.venv、Pods等目录,直接显示每个项目最后一次改动的时间。 - 被 Git 跟踪的内容一律跳过,近期有写入的活跃项目会自动标出并禁止误选。
- 所有项目产物属于「需要确认」(默认不勾选),删除时一律移到废纸篓,万一删错随时可以放回原处。
pnpm store在 CleanBit 里仅展示大小、不直接删除,并提示你使用pnpm store prune。
- Mac App Store(扫描免费,前 2 次清理免费):apps.apple.com/app/apple-s…
- 本文官网原文:getcleanbit.app/zh/guides/m…
常见问题
删掉 node_modules 会影响全局 npm 包或 Node.js 环境吗?
不会。项目目录下的 node_modules 只属于当前项目,不影响全局安装的 CLI 工具或源代码。
为什么删完之后,访达里看到的可用空间没有立刻变多?
常见原因有两个:如果是移到废纸篓,需要清空废纸篓才会释放;如果是 pnpm 项目,因为存在硬链接,需要再执行 pnpm store prune。此外 macOS 的本地时间机器快照(APFS 快照)也可能导致系统延迟更新可用空间。
说明:本文由 CleanBit 开发者借助 AI 整理,数据为作者在一台开发用 Mac 上实测。原文首发于 CleanBit 官网:Mac 上怎么找出并安全清理旧的 node_modules?