Monorepo 中包之间互相依赖怎么联调？workspace:* 怎么用？

Question

仓乃文 · Accepted Answer

Monorepo 中多个包互相依赖时，联调是核心痛点。用 npm link 有双实例问题，pnpm workspace:* 协议完美解决了这个问题。

workspace 协议：
```json
// packages/ui/package.json
{ "name": "@acme/ui", "version": "1.0.0" }

// packages/app/package.json
{
  "dependencies": {
    "@acme/ui": "workspace:*"  // 指向本地 workspace
  }
}
```

workspace:* 的行为：
```
开发环境：workspace:* → 软链接到 packages/ui
  修改 ui 的代码，app 立即生效（HMR 正常）

发布时：workspace:* → 替换为实际版本号
  "@acme/ui": "workspace:*" → "@acme/ui": "1.0.0"
```

联调常见问题：
```bash
# 问题 1：修改了共享包但 app 没有更新
# 原因：共享包需要先构建
pnpm --filter @acme/ui build

# 问题 2：React 双实例问题
# 修复：把 React 放 peerDependencies 或提升到根目录
# .npmrc
public-hoist-pattern[]=*react*

# 问题 3：发布后 workspace:* 没有替换
# 修复：用 pnpm publish
pnpm --filter @acme/ui publish
```

pnpm workspace 配置：
```yaml
# pnpm-workspace.yaml
packages:
  - "apps/*"
  - "packages/*"

# 常用命令
pnpm -r list                    # 列出所有包
pnpm --filter @acme/app dev     # 只启动 app
pnpm --filter "./packages/*" build  # 构建所有 packages
```

补充说明：
- workspace:* 是 Monorepo 联调的正确姿势，不要用 npm link
- 共享库的框架依赖必须放 peerDependencies
- 修改共享包后需要重新 build
- 发布用 pnpm publish，自动替换 workspace:* 为版本号
- 规则：内部依赖用 workspace:*，外部依赖用正常版本号