本文首发于公众号「程序员大华」，专注前端、Java、AI工具的实战分享。若觉得有帮助，请点个赞、转发一下~ 😊

在一次普通的 npm install 或者 yarn add 之后项目根目录里会出现一个名为 node_modules 的庞然大物。它并不是一个“单纯的文件夹”，而是：

上万甚至数十万个文件的集合；

每个依赖dou可Neng带着自己的子依赖形成深度嵌套；

同一个库的不同版本往往会共存，导致空间翻倍。

举个Zui常见的例子：Ru果项目使用了 Vue、Axios、Lodash、Webpack 等，安装完毕后你会在 node_modules 中kan到类似下面的结构：

├─ vue
│  └─ ...
├─ axios
│  └─ follow-redirects
├─ webpack
│  ├─ loader-utils
│  └─ schema-utils
└─ lodash
   └─ ...

如此庞大的目录，在磁盘上往往占据数百 MB，甚至上 GB。

操作系统在递归遍历目录时需要打开、关闭每一个文件句柄。即使 SSD 的随机读取速度远高于机械硬盘，但面对数十万甚至上百万小文件时仍旧会出现 “卡顿”——因为每一次 I/O dou要走一次系统调用栈。

Windows 上默认使用 NTFS，macOS 则是 APFS。两者在面对海量碎片化的小文件时dou倾向于先Zuo元数据geng新，再进行实际删除。这一步骤比一次性删除一个大文件慢得多。

当你执行删除指令时安全软件会对每个被标记为“可疑”的路径进行扫描。Ru果你的机器装有多款防护软件，这种逐个检查会把原本几秒钟的操作拉长到数分钟。

C:\project ode_modules\@babel\preset-env\… ode_modules\…\…\…\index.js 当路径长度逼近 260 个字符时系统需要额外Zuo一次 “短路径” 转换，这也是拖慢进度的一根刺。

有些包在运行期间会打开临时文件或保持句柄未释放，导致删除时出现 “资源忙碌” 的错误提示。这种情况下系统会尝试多次重试，从而进一步拖慢整体速度。

# Zui常见但稍作改动的写法
rm -rf ./node_modules   # “强制递归”，省去交互确认
# Ru果你使用的是 Zsh，Ke以开启 globstar，让 rm 一口气遍历所有子目录
shopt -s globstar && rm -rf ./node_modules/**/*

小贴士：在 SSD 环境下把目录先移动到 /tmp 再删，有时候Neng让磁盘调度geng高效。

rimraf：

# 全局安装一次以后随处可用
npm i -g rimraf
# 项目根目录直接跑：
rimraf node_modules
# 或者 npx rimraf node_modules   # 不需要提前安装

Powershell 原生脚本：

Remove-Item -Path .
ode_modules -Recurse -Force
# geng快一点的老派写法：
rd /s /q node_modules

Pnpm 的硬链接特性：

# pnpm 会把真实包内容放进全局 store，只在项目里创建硬链接。
pnpm store prune          # 清理无用缓存，让后续删除geng轻松
pnpm uninstall --no-save # Ru果只是想把某个包踢出，可直接用这个命令。

You’ve heard of Yarn Plug’n’Play 吗？：

# 启动 PnP 后根本不生成 node_modules，大幅削减磁盘占用和删除成本。
yarn config set pnpEnabled true
yarn install               # 完全基于虚拟映射，无需实际文件夹。

Ru果你经常切换分支或重装依赖，Ke以考虑把整个开发环境搬进 Docker：

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci               # 安装完后所有依赖dou在镜像内部
CMD 

只需要删掉容器或重新 build 镜像，即可“一键清空”。同理，WSL2 或者 Vagrant 虚拟机也Neng实现类似效果。

关闭 Windows 实时保护：

Set-MpPreference -DisableRealtimeMonitoring $true   # 暂停防病毒实时扫描
Remove-Item -Recurse -Force .
ode_modules       # 再来一次你会发现明显提速。
Set-MpPreference -DisableRealtimeMonitoring $false # 完事记得恢复！

LinuX 下调高 inode 缓存：

sudo sysctl -w vm.max_map_count=262144   # 提升内核对大量小文件映射的容忍度。
sudo sync && echo 3> /proc/sys/vm/drop_caches   # 清理页缓存，让磁盘直接写入。
rm -rf node_modules                     # 
执行删档操作。

MacOS 开启“快速抹除”模式：

sudo tmutil disablelocal                # 暂停 Time Machine 快照，以免产生额外 IO。
rm -rf ./node_modules                  # 删除……
sudo tmutil enablelocal                 # 完事后记得恢复监控。

尽量采用 pnpm 或 Yarn PnP：PnP 把所有依赖压缩进单一缓存，不再产生巨型 folder；pnpm 则通过硬链接复用相同内容，大幅降低磁盘占用和递归深度。

定期清理缓存：`npm cache clean --force` 或 `pnpm store prune` Neng把陈旧版本踢掉，让后面的安装/卸载geng轻盈。

别让 IDE/编辑器盯着整个 folder kan：Sublime Text/VSCode 在打开项目时会遍历全部子目录进行索引；关闭自动索引或排除 `node_modules` Neng显著提升 UI 响应速度，也间接减轻系统负担。

使用 Git 工作流而非手动删档：`git clean -fdx` Neng一次性清除未跟踪文件，包括 `node_modules`，且比手写脚本geng可靠。

给大型仓库加一层 “软链接” 缓冲区：`ln -s $/node_modules ~/.cache/myproj-modules` 把真实数据搬到 SSD 高速区，再通过软链接挂回项目根目录，删除软链接几乎瞬间完成。

"删不掉" 并不意味着机器坏了也不是你敲错了指令。它是 Node.js 包管理生态多年累积下来的副作用。只要了解背后的原因，对症下药，就Neng把那几分钟变成几秒钟。

Ru果你Yi经尝试了以上方法仍然卡顿，那可Neng是硬件瓶颈或者磁盘健康出现问题。建议跑一下) 检查一下硬盘状态吧！😉