添加mat-date-picker后Angular项目npm install peer依赖报错求助

核心排查方向&解决方案 #

• 同步依赖锁定文件
  本地环境正常说明依赖树已兼容，将本地生成的package-lock.json（或pnpm-lock.yaml/yarn.lock，取决于你用的包管理器）提交到代码仓库，其他设备执行npm ci（而非npm install），该命令会严格按照锁定文件安装依赖，避免版本差异导致的peer依赖冲突。

• 强制匹配Angular与Material版本
  mat-date-picker属于Angular Material组件，要求@angular/core、@angular/material、@angular/cdk三者版本完全一致：

  1. 查看本地正常环境的版本：执行npm list @angular/material获取精确版本号
  2. 在其他设备手动安装匹配版本：

     npm install @angular/material@x.x.x @angular/cdk@x.x.x @angular/core@x.x.x --save-exact
     

  3. 修改package.json中上述依赖的版本号，去掉前缀^或~，锁定为精确版本（比如"@angular/material": "15.2.9"而非"@angular/material": "^15.2.9"）

• 彻底清理依赖环境
  尝试更彻底的清理步骤，确保无残留缓存：

  rm -rf node_modules package-lock.json
  npm cache clean --force
  npm install --legacy-peer-deps
  

  --legacy-peer-deps会忽略npm 7+的严格peer依赖校验规则，适配部分未及时更新peer依赖声明的包。

• 统一Node.js版本
  不同Node.js版本可能影响依赖解析逻辑，使用nvm（Node Version Manager）将其他设备的Node.js版本切换为与本地一致：

  nvm install x.x.x
  nvm use x.x.x
  

内容的提问来源于stack exchange，提问作者Rafael Oliveira