执行npm install安装依赖无报错但node_modules文件夹消失如何解决

1 排查安装过程的具体错误 #

• 执行带详细日志的安装命令，定位失败节点：

  npm install --verbose
  

  重点查看安装停止前最后输出的操作记录，该异常默认触发了npm的自动回滚机制，才会删除已生成的node_modules目录
• 查看npm本地日志：安装失败后npm会生成日志文件，路径会在终端最后几行输出，打开日志搜索error、failed关键词确认失败原因

2 缓存与基础环境校验 #

• 执行命令校验并清理损坏的npm缓存：

  npm cache verify
  npm cache clean --force
  

• 确认Node.js与npm版本和项目Angular版本匹配：Angular各大版本对Node.js版本范围有严格要求，版本不兼容会出现无报错隐性失败，可通过node -v、npm -v查看当前版本，和项目要求的版本范围做比对
• 检查项目目录权限：确保当前用户对项目目录有完整读写权限，不要用管理员/root权限执行npm install，避免npm安全机制触发回滚；Windows环境下需确认项目路径无中文、特殊字符、空格，且没有被杀毒软件、文件管理器锁定占用

3 依赖与生命周期脚本排查 #

• 临时禁用安装脚本测试：

  npm install --ignore-scripts
  

  如果执行后node_modules正常生成不被删除，说明是package.json中声明的preinstall/postinstall等生命周期脚本，或是某依赖的内置安装脚本执行出错触发回滚，可针对性排查对应脚本逻辑
• 检查依赖版本冲突：执行npm ls查看是否存在依赖版本不兼容问题，重点核对@angular系列核心包版本是否统一，没有跨大版本混用的情况

4 替代方案 #

如果上述步骤都无法定位问题，可切换其他包管理器尝试安装：

• 使用pnpm安装：

  npm install -g pnpm
  pnpm install
  

• 使用yarn安装：

  npm install -g yarn
  yarn install
  

内容的提问来源于stack exchange，提问作者Excel Bill