安装@ngbmodule/material-carousel遇依赖冲突，本地生效但Vercel部署失败

问题场景 #

尝试安装@ngbmodule/material-carousel@0.7.2时，触发peer依赖冲突：

Found: @angular/material@13.3.9
npm ERR! node_modules/@angular/material
npm ERR! @angular/material@"^13.3.9" from the root project
npm ERR!
npm ERR! Could not resolve dependency:
npm ERR! peer @angular/material@"^10.0.1" from @ngbmodule/material-carousel@0.7.2
npm ERR! node_modules/@ngbmodule/material-carousel
npm ERR! @ngbmodule/material-carousel@"*" from the root project
npm ERR!
npm ERR! Fix the upstream dependency conflict, or retry
npm ERR! this command with --force, or --legacy-peer-deps
npm ERR! to accept an incorrect (and potentially broken) dependency resolution.
npm ERR!
npm ERR! See /Users/dtech/.npm/eresolve-report.txt for a full report.

使用npm install --force强制安装后，本地项目可正常运行，但部署到Vercel时再次报错：

npm ERR! While resolving: @ngbmodule/material-carousel@0.7.2
npm ERR! Found: @angular/material@13.3.9
npm ERR! node_modules/@angular/material
npm ERR! @angular/material@"^13.3.9" from the root project
npm ERR!
npm ERR! Could not resolve dependency:
npm ERR! peer @angular/material@"^10.0.1" from @ngbmodule/material-carousel@0.7.2
npm ERR! node_modules/@ngbmodule/material-carousel
npm ERR! @ngbmodule/material-carousel@"^0.7.2" from the root project

解决思路及方案 #

1. 让Vercel忽略peer依赖冲突 #

Vercel默认启用严格的peer依赖校验，和本地强制安装的逻辑不一致。解决办法是在项目根目录创建.npmrc文件，添加以下内容：

legacy-peer-deps=true

这样部署时npm会以兼容模式处理依赖，跳过peer版本冲突校验，和本地运行环境保持一致。

2. 替换为兼容的轮播组件 #

@ngbmodule/material-carousel@0.7.2仅支持Angular Material 10.x版本，和当前使用的13.x版本跨度较大，后续可能出现未知兼容性问题。建议更换为支持Angular 13的轮播组件：

• 直接使用Angular Material官方提供的轮播组件（Angular 13已内置相关功能，无需额外安装第三方库）
• 选择其他维护活跃、明确兼容Angular 13的第三方轮播库

3. 降级Angular Material版本 #

如果必须使用@ngbmodule/material-carousel@0.7.2，可以将项目的@angular/material降级到^10.0.1，同时需要同步降级Angular核心框架及其他相关依赖到10.x版本，确保整个项目依赖版本统一，避免其他冲突。

内容的提问来源于stack exchange，提问作者A.Mac