如何解决 node_modules 中，同一个包安装了多个不同版本的问题？

在 node_modules 中遇到同一个包的多个版本问题，通常是由于不同依赖包对该包有不同的版本要求。解决这个问题有几个常用的方法：

1. 使用 npm 或 yarn 的解析策略

1.1 使用 npm 的 dedupe

• npm dedupe 会尝试减少 node_modules 中重复的包版本，使得可能的依赖只会使用一个版本。

  npm dedupe
  

1.2 使用 yarn 的 resolutions

• yarn 提供了 resolutions 字段，可以强制使用某个版本的依赖包。

  // package.json
  {
    "resolutions": {
      "package-name": "desired-version"
    }
  }
  

  • 使用 yarn install 时，yarn 会使用 resolutions 中指定的版本。

2. 合并和升级

2.1 手动合并依赖

• 查找所有 package.json 文件中依赖的版本，尝试将它们合并到一致的版本。然后更新 package-lock.json 或 yarn.lock 文件。

2.2 升级依赖

• 如果可能，升级所有依赖到最新版本，以减少版本冲突。例如，使用 npm-check-updates 工具来批量更新依赖。

  npx npm-check-updates -u
  npm install
  

3. 使用 pnpm 作为包管理工具

• pnpm 使用一种不同的策略来管理包，使得 node_modules 目录中的依赖可以被高效共享，减少版本冲突。

  npm install -g pnpm
  pnpm install
  

4. 定制依赖包版本

4.1 使用 package.json 的 peerDependencies

• 如果你的项目是一个库或插件，使用 peerDependencies 来指定你支持的包版本，而不是直接依赖它们。这样可以避免在 node_modules 中安装多个版本。

4.2 使用 resolutions （对于 npm 7+）

• 在 npm 7+ 版本中，也可以使用类似 yarn 的 resolutions 解决版本冲突。需要在 package.json 中设置 overrides。

  // package.json
  {
    "overrides": {
      "package-name": "desired-version"
    }
  }