在笔记本电脑上初始化Vue2Vis时遇到npm依赖冲突如何解决？

问题根因 #

这是npm v7及以上版本严格校验peer依赖版本匹配触发的报错：@vue2vis/graph2d@1.0.1-alpha.0声明依赖uuid@^7.0.0，但其依赖的vis-timeline@7.3.4要求peer依赖的uuid版本必须为^3.4.0，两个版本范围不匹配导致安装终止。

解决方案 #

按稳妥性从高到低排序：

• 主动对齐peer依赖要求
  先安装符合vis-timeline要求的uuid版本，再执行原有安装命令，从依赖版本层面解决冲突，适合长期使用的场景：

  npm install --save uuid@^3.4.0
  npm install --save @vue2vis/graph2d vis-data moment
  

• 临时忽略peer依赖校验
  在原有安装命令后加--legacy-peer-deps参数，让npm跳过peer依赖版本冲突检查，直接使用项目声明的依赖版本，适合快速测试验证的场景：

  npm install --save @vue2vis/graph2d vis-data moment --legacy-peer-deps
  

• 项目层面修复（适合克隆仓库二次开发的场景）
  打开仓库下packages/graph2d/package.json文件，将devDependencies中uuid的版本号从^7.0.0改为^3.4.0，再重新执行依赖安装即可。

注意事项 #

不推荐使用--force参数执行安装，该参数会强制覆盖已存在的依赖版本，大概率会引发其他隐性依赖问题。

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