如何在Mac系统上正确清理删除node_modules目录释放磁盘空间

你看到的Thomas Large提供的全量删除命令，存在明显的使用场景误导性，没有前置操作指引的情况下直接执行极易误删关键文件，核心问题有三个：

• 命令没有限定扫描范围，只要执行时的终端工作目录是用户根目录、系统盘根目录，就会遍历从当前位置开始的所有子目录，把全局Node环境、第三方Electron应用内置的node_modules全部纳入删除匹配范围
• 命令没有设置路径排除规则，会把带软链接的失效node_modules缓存、无权限访问的受保护目录一并纳入匹配逻辑，遇到路径匹配偏差时，rm -rf的操作没有兜底校验
• 你之前排查空间时遇到的“部分路径不存在”报错，本质是find遍历过程中遇到无权限目录、软链接失效路径导致的，这类异常如果直接对接删除操作，存在路径解析偏差导致的误删风险

核心原则是严格区分项目本地依赖、全局Node依赖的边界，既把空间腾出来，又不破坏现有开发环境：

• 两类node_modules的可删除性判断
  • 项目根目录下的本地node_modules：可以安全删除，所有依赖都能通过项目自带的package.json、锁文件（package-lock.json/yarn.lock/pnpm-lock.yaml）1:1重新安装恢复，没有任何不可逆损失
  • 全局Node安装路径下的node_modules：绝对不能手动删除，这是你全局安装的CLI工具（比如pm2、tsc、各类项目脚手架）的运行依赖，删了会直接导致全局命令失效。这部分路径可以通过执行npm root -g快速查到，提前排除在扫描范围外
• 分批次、限定范围执行清理，不要图省事扫全盘
  • 对于长期不维护的旧项目，直接进入对应项目目录手动删除node_modules是最稳妥的方式，完全不会扫到无关路径
  • 如果你需要批量清理所有存放在项目文件夹下的node_modules，先把find的扫描范围限定在你统一存放项目的文件夹（比如~/Projects），同时加上全局目录的排除规则，先跑排查命令确认清单：
    $ find ~/Projects -name "node_modules" -type d -prune -not -path "*/.nvm/*" -not -path "*/node/versions/*" | xargs du -chs
  • 确认清单里没有需要临时保留依赖的活跃项目后，再在完全相同的路径范围内执行删除，同样要保留排除规则：
    $ find ~/Projects -name "node_modules" -type d -prune -not -path "*/.nvm/*" -not -path "*/node/versions/*" -exec rm -rf '{}' \;
• 完全不需要重新安装Node环境
  • 只要你的扫描范围没有覆盖到全局Node安装路径，删除项目本地node_modules的操作，根本不会影响Node本体的运行
  • 所有关于“删完node_modules要重装Node”的说法，本质是之前的用户执行无范围全量删除时，误删了全局环境下的node_modules才导致的异常，不是项目本地依赖删除带来的必然结果

• 执行任何find删除命令前，先把-exec rm -rf部分去掉，先打印一遍所有匹配到的路径，逐行确认没有敏感路径之后，再加上删除逻辑执行，避免参数拼接出错
• 扫描时遇到的无权限、失效路径报错，可以在find命令末尾加2>/dev/null屏蔽，不影响正常目录的扫描结果
• 如果你的项目使用pnpm做包管理，注意区分项目本地的node_modules和pnpm的全局依赖存储目录，后者不需要手动删除，会在pnpm的日常清理命令下自动回收冗余空间

内容的提问来源于stack exchange，提问作者Vania Dimova