Angular Monorepo中Lib3本地引用Lib1/Lib2并保留传递依赖方案咨询

针对你在Angular monorepo中遇到的lib3本地引用lib1/lib2、同时保留传递依赖的问题，以下是可行的实现方案：

1. 配置npm Workspaces实现本地链接 #

在根目录package.json中添加workspaces配置，指定所有库的路径：

{
  "name": "monorepo-root",
  "workspaces": [
    "projects/lib1",
    "projects/lib2",
    "projects/lib3"
  ]
}

执行npm install，npm会自动将lib1、lib2本地链接到lib3的node_modules中，替代远程包。

2. 调整lib3的package.json声明依赖 #

将lib1、lib2同时加入dependencies和peerDependencies：

{
  "name": "@your-org/lib3",
  "version": "1.0.0",
  "dependencies": {
    "@your-org/lib1": "^1.0.0",
    "@your-org/lib2": "^1.0.0"
  },
  "peerDependencies": {
    "@your-org/lib1": "^1.0.0",
    "@your-org/lib2": "^1.0.0",
    "@angular/core": "^15.0.0"
  }
}

• dependencies：确保本地开发时npm workspaces能关联到本地包；
• peerDependencies：确保外部应用安装lib3时，npm（7+版本）会自动安装兼容版本的lib1、lib2，实现传递依赖。

3. 配置TypeScript项目引用确保编译依赖 #

在lib3的tsconfig.lib.json中添加项目引用：

{
  "compilerOptions": {
    // 保留原有编译配置
  },
  "references": [
    { "path": "../lib1/tsconfig.lib.json" },
    { "path": "../lib2/tsconfig.lib.json" }
  ]
}

根目录tsconfig.json也启用项目引用：

{
  "compilerOptions": {
    // 保留原有编译配置
  },
  "references": [
    { "path": "./projects/lib1" },
    { "path": "./projects/lib2" },
    { "path": "./projects/lib3" }
  ]
}

执行tsc -b可增量编译所有依赖库，保证本地开发时类型检查和编译正确性。

4. 构建与发布流程 #

• 本地开发：直接运行ng build lib3，Angular CLI会自动先构建依赖的lib1、lib2，且使用本地链接的包，无需提前发布到npm；
• 发布：
  1. 先发布lib1、lib2到npm仓库，确保版本号与lib3的package.json中声明的一致；
  2. 再发布lib3，外部应用安装@your-org/lib3时，npm会自动拉取对应的lib1、lib2版本。

验证本地引用有效性 #

执行npm ls @your-org/lib1，若输出显示lib1来自本地projects/lib1目录，说明本地链接配置成功。

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