Vercel部署React应用遇npm install错误：依赖版本冲突

问题原因 #

项目存在依赖冲突：react-scripts@5.0.1的peer依赖要求TypeScript版本为^3.2.1 || ^4，但当前使用的typescript@5.3.3超出了支持范围，导致npm无法解析依赖关系。

解决方案 #

方案1：降级TypeScript到兼容版本 #

直接将TypeScript降级到4.x最新稳定版，匹配react-scripts的依赖要求：

npm install typescript@^4.9.5 --save-exact

执行命令后提交代码到仓库，重新触发Vercel部署即可。

方案2：修改Vercel安装命令，忽略peer依赖冲突 #

若不想降级TypeScript，可在Vercel中强制跳过peer依赖检查：

• 进入Vercel项目的Settings页面
• 找到Build & Development Settings区域
• 将Install Command修改为：

npm install --legacy-peer-deps

保存设置后重新部署，此方法会忽略依赖冲突，但可能存在潜在兼容性问题，建议先在本地执行该命令确保项目能正常运行。

方案3：升级react-scripts到支持TypeScript 5的版本（谨慎使用） #

react-scripts 5.x不支持TypeScript 5+，可尝试升级到beta版的6.x（已兼容TS5）：

npm install react-scripts@next --save

注意：beta版本可能存在不稳定问题，升级后需全面测试项目功能，确认无异常再部署。

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