无法删除项目node_modules文件夹 常规删除失效无法执行npm i
2026-8-26
Windows系统下无法删除损坏node_modules的解决方法
node_modules无法删除在Windows环境下基本是两类原因：进程占用文件、嵌套依赖路径过长超过系统路径长度限制，按以下步骤操作即可解决：
- 第一步：先结束所有占用进程
关闭所有打开的VS Code、项目终端、正在运行的本地node服务（比如npm run dev启动的开发服务），打开任务管理器，找到所有名称带node、npm的进程，右键选择结束任务。 - 第二步：优先用专用工具删除（成功率最高）
- 以管理员身份打开PowerShell或命令提示符，进入项目根目录
- 全局安装专门处理深度/损坏文件夹删除的工具：
npm install -g rimraf - 执行删除命令：
rimraf node_modules - 清理npm缓存避免遗留问题：
npm cache clean --force - 可选操作：删除旧的依赖锁定文件
package-lock.json - 重新执行
npm i安装依赖即可
- 备选方案：不装第三方工具，用系统自带命令删除
如果不想额外安装工具，在管理员权限的终端中进入项目根目录，执行系统强制递归删除命令：rd /s /q node_modules
如果执行后提示路径过长无法删除，可手动进入node_modules，把深层嵌套的上级文件夹挨个重命名为单字符短名称（比如把长名称的依赖文件夹重命名为1、2），缩短整体路径长度后再执行删除命令即可。 - 极端情况兜底方案：安全模式删除
如果以上操作都无效，按住Shift键点击Windows系统的重启按钮，进入「疑难解答-高级选项-启动设置」，选择带命令提示符的安全模式启动，进入项目目录后执行上述删除命令即可，安全模式下无第三方进程占用文件，可100%删除损坏文件夹。
安装依赖时如果反复报错，可切换npm源为国内镜像后重试，命令为：
npm config set registry https://registry.npmmirror.com
内容的提问来源于stack exchange，提问作者mellows
相关产品推荐
相关产品推荐
