NX与Angular可发布库构建时配置peerDependencies自动添加^符号方法

NX 构建可发布类库时，自动推导生成的跨库peerDependencies默认使用精确版本号，会导致下游项目必须匹配精确依赖版本，产生不必要的联动发版成本，通过NX原生配置即可实现自动添加caret（^）前缀，无需手动修改构建产物。

方案1：全局统一配置（推荐，全仓库类库生效） #

修改仓库根目录的nx.json文件，在构建任务的默认配置中添加版本前缀参数，一次配置对所有可发布类库生效：

{
  // 保留nx.json原有其他配置
  "targetDefaults": {
    "build": {
      // 保留原有build配置（如dependsOn等）
      "options": {
        "updateBuildableProjectDepsInPackageJson": true,
        "buildableProjectDepsInPackageJsonType": "peerDependencies",
        // 核心配置：指定自动生成的内部依赖版本前缀
        "versionPrefix": "^"
      }
    }
  }
}

方案2：单类库独立配置（仅对指定类库生效） #

如果不需要全仓库统一规则，仅需要给lib_A这类需要发NPM的类库单独配置，直接打开对应类库目录下的project.json（老版本NX可在根目录angular.json对应项目配置段修改），找到build目标的options块添加配置：

{
  "targets": {
    "build": {
      "executor": "@nrwl/angular:package",
      "options": {
        "project": "libs/lib_A/ng-package.json",
        // 保留原有其他构建配置
        // 核心配置
        "updateBuildableProjectDepsInPackageJson": true,
        "versionPrefix": "^"
      }
    }
  }
}

注意事项 #

• 若你使用的NX版本低于16.8，将上述配置中的versionPrefix替换为peerDepsVersionPrefix即可，配置值仍为"^"。
• 配置完成后重新执行类库构建命令，dist目录下生成的package.json中，自动推导的peerDependencies会自动带上^前缀，不需要提前在源码的package.json中手写依赖版本，NX会自动读取仓库内依赖的当前版本拼接前缀生成。
• 若存在个别依赖需要固定精确版本、不需要加前缀的场景，直接在类库源码根目录的package.json中手动写对应peerDependencies的版本规则即可，NX构建时会优先读取手写配置，不会被自动生成规则覆盖。
• 不推荐编写自定义postbuild脚本修改构建产物的package.json，原生配置稳定性更高，不会因为NX版本升级出现兼容问题。

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