Angular项目npm install报错与构建失败求助

问题根源 #

1. 依赖版本不兼容：@angular/cdk@12.2.13与@angular/common@14.2.12版本差距过大，peer依赖校验失败，导致初始npm install报错。
2. Node/npm版本不匹配：项目依赖的@angular-devkit/core@10.2.3要求npm 6.x/7.x、Node >=10.13，而你当前使用的Node 18.x和npm 9.x版本过高，引发引擎不兼容警告，最终导致启动失败。

分步解决方案 #

1. 匹配Node/npm版本（最关键） #

用Node版本管理器（nvm）切换到项目兼容的版本：

• 安装nvm后，执行以下命令安装并切换到兼容版本（以Node 14.21.3为例，对应npm 6.14.18，符合项目要求）：

  nvm install 14.21.3
  nvm use 14.21.3
  

• 验证版本：

  node -v # 应输出v14.21.3
  npm -v # 应输出6.14.18左右
  

2. 清理旧依赖并重新安装 #

• 删除现有依赖文件：

  # macOS/Linux
  rm -rf node_modules package-lock.json
  # Windows
  rmdir /s /q node_modules && del package-lock.json
  

• 重新执行安装：

  npm install
  

3. 对齐Angular核心依赖与CDK版本 #

如果步骤2仍出现peer依赖错误，打开package.json，将@angular/cdk的版本修改为与@angular/common一致的14.x.x（比如14.2.12），保存后再次执行npm install。

4. 启动项目 #

执行启动命令：

npm start

关于漏洞的说明 #

当前出现的40个漏洞是由于项目依赖版本较旧导致的，先保证项目能正常运行，后续可逐步升级Angular版本（从14升级到稳定版）来修复漏洞，不要直接执行npm audit fix，否则可能引发更多依赖冲突。

内容的提问来源于stack exchange，提问作者Kurtnox CCC