无需发布，如何解决pnpm workspace中TS monorepo构建依赖缺失问题

不用发布包就能解决这个问题，核心是让TypeScript正确识别pnpm workspace里的本地依赖，下面是几个实用方案：

1. 配置TypeScript路径映射 #

在bar包的tsconfig.json（或根目录统一的tsconfig.json）中添加paths和baseUrl，告诉TSfoo模块对应的本地源码路径：

// bar包的tsconfig.json
{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "foo": ["../foo/src"],
      "foo/*": ["../foo/src/*"] // 支持子路径导入
    }
  }
}

如果用根目录统一管理TS配置，可在根tsconfig.json中配置后让子包继承：

// 根tsconfig.json
{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "foo": ["packages/foo/src"],
      "foo/*": ["packages/foo/src/*"]
    }
  },
  "include": ["packages/**/src"]
}

子包的tsconfig.json继承配置：

{
  "extends": "../../tsconfig.json",
  "compilerOptions": {
    "outDir": "./dist"
  },
  "include": ["src"]
}

2. 确保pnpm workspace依赖正确链接 #

执行命令重新安装依赖，确保foo被软链到bar的node_modules中：

pnpm install

如果链接异常，可强制重新添加workspace依赖：

pnpm -F bar add foo@workspace

3. 按依赖顺序串联构建脚本 #

因为bar依赖foo，需要先构建foo再构建bar，在根目录package.json中添加串联脚本：

{
  "scripts": {
    "build:foo": "pnpm -F foo build",
    "build:bar": "pnpm -F bar build",
    "build": "pnpm run build:foo && pnpm run build:bar"
  }
}

同时确保foo包的package.json正确声明构建产物入口：

{
  "main": "./dist/index.js",
  "types": "./dist/index.d.ts"
}

4. 使用TS增量构建（推荐） #

TypeScript的增量构建会自动处理依赖顺序，先在根目录创建tsconfig.build.json：

{
  "files": [],
  "references": [
    {"path": "./packages/foo"},
    {"path": "./packages/bar"}
  ]
}

然后给每个子包的tsconfig.json添加composite配置：

{
  "compilerOptions": {
    "composite": true,
    "declaration": true,
    "outDir": "./dist"
  },
  "include": ["src"]
}

最后执行增量构建命令：

tsc -b tsconfig.build.json

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