使用caret(^)或tilde(~)时NPM依赖重复安装该如何解决？

1. 该行为是否为NPM预期行为 #

是，完全符合NPM的依赖解析规则，核心原因是多数开发者对^（插入号）版本规则的认知存在偏差：

当依赖版本的主版本号为0（即处于非稳定迭代阶段）时，^0.x.y规则仅允许匹配次版本号相同、修订号大于等于y的版本，不会跨次版本号兼容。

你的场景中：

• @myGroup/someLib依赖的@myGroup/common@^0.3.0，实际允许的版本范围是>=0.3.0 <0.4.0
• 主应用固定的@myGroup/common@0.10.0不在上述范围内，NPM无法将两个依赖合并扁平化，因此会分别安装两个版本，属于预期行为。

2. 如何配置实现仅安装一个版本的@myGroup/common #

你可以根据自身场景选择以下两种方案：

• 方案1：主应用侧强制版本覆盖（适合无法修改依赖库配置的场景，npm 8.3及以上版本支持）
  在主应用的package.json中新增overrides字段，强制@myGroup/someLib使用主应用声明的版本：

{
  "name": "My App",
  "dependencies": {
    "@myGroup/someLib": "0.2.0",
    "@myGroup/common": "0.10.0"
  },
  "overrides": {
    "@myGroup/someLib": {
      "@myGroup/common": "$@myGroup/common"
    }
  }
}

注意：该方案需要你自行验证@myGroup/someLib和@myGroup/common@0.10.0的兼容性，避免出现逻辑错误。

• 方案2：修改@myGroup/someLib的依赖范围（适合可以自主维护依赖库的场景）
  将@myGroup/someLib中@myGroup/common的依赖范围调整为包含0.10.0的区间，比如：

{
  "name": "@myGroup/someLib",
  "dependencies": {
    "@myGroup/common": ">=0.3.0 <1.0.0"
  }
}

调整后0.10.0符合版本范围要求，NPM会自动做依赖扁平化，仅安装一个版本。

3. 是否应该改用peerDependencies声明该依赖 #

如果满足以下任一特征，非常推荐改用peerDependencies（同伴依赖）声明：

• @myGroup/common是你们团队的基础公共库，要求所有业务项目统一版本
• 该库存在单例要求，多版本共存会导致逻辑冲突、样式污染等问题

你可以将@myGroup/someLib中的@myGroup/common从dependencies移动到peerDependencies中：

{
  "name": "@myGroup/someLib",
  "peerDependencies": {
    "@myGroup/common": "^0.3.0 || ^0.10.0"
  }
}

配置后NPM不会为@myGroup/someLib自动安装单独的@myGroup/common，只会要求主应用自行安装符合范围的版本，从机制上避免多版本共存的问题。

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