基于 pnpm + Turborepo 的全栈 Monorepo 实践：从类型共享到 CI 缓存治理

.
├── apps
│   ├── web                # 前端应用 (Next.js / Vite)
│   └── api                # 后端服务 (NestJS / Hono / Fastify)
├── packages
│   ├── contracts          # 前后端共享：接口契约、Zod Schema、TS 类型
│   ├── utils              # 纯函数工具库
│   ├── tsconfig           # 共享的 TypeScript 配置
│   └── eslint-config      # 共享的规范配置
├── pnpm-workspace.yaml
├── turbo.json
└── package.json

packages:
  - 'apps/*'
  - 'packages/*'

// packages/contracts/src/user.ts
import { z } from 'zod';

// 1. 运行时校验 Schema
export const CreateUserSchema = z.object({
  email: z.string().email('邮箱格式不正确'),
  nickname: z.string().min(2, '昵称至少 2 个字符').max(20),
  role: z.enum(['admin', 'member']).default('member'),
});

// 2. 从 Schema 推导静态类型
export type CreateUserInput = z.infer<typeof CreateUserSchema>;

// apps/web/src/components/RegisterForm.tsx
import { CreateUserSchema, CreateUserInput } from '@repo/contracts';
import { useForm } from 'react-hook-form';
import { zodResolver } from '@hookform/resolvers/zod';

export const RegisterForm = () => {
  const { register, handleSubmit, formState: { errors } } = useForm<CreateUserInput>({
    resolver: zodResolver(CreateUserSchema),
  });

  const onSubmit = (data: CreateUserInput) => {
    // 调用 API
  };

  // ...
};

// apps/api/src/routes/user.ts
import { Hono } from 'hono';
import { zValidator } from '@hono/zod-validator';
import { CreateUserSchema } from '@repo/contracts';

const app = new Hono();

app.post('/users', zValidator('json', CreateUserSchema), async (c) => {
  // 此时 data 的类型已被推断为 CreateUserInput，且已完成运行时校验
  const data = c.req.valid('json');
  // 执行落库逻辑...
  return c.json({ success: true, data });
});

{
  "name": "@repo/contracts",
  "version": "0.0.1",
  "private": true,
  "main": "./src/index.ts",
  "types": "./src/index.ts",
  "exports": {
    ".": "./src/index.ts"
  }
}

{
  "$schema": "https://turbo.build/schema.json",
  "tasks": {
    "build": {
      "dependsOn": ["^build"],
      "inputs": ["src/**", "package.json", "tsconfig.json"],
      "outputs": ["dist/**", ".next/**", "!.next/cache/**"]
    },
    "test": {
      "dependsOn": ["^build"],
      "inputs": ["src/**", "**/*.test.ts"]
    },
    "lint": {
      "dependsOn": ["^topo"]
    },
    "dev": {
      "cache": false,
      "persistent": true
    }
  }
}

# GitHub Actions 示例片段
- name: Run checks on affected projects
  run: pnpm turbo run lint test build --filter=...[origin/main]

TURBO_API="https://your-internal-cache-service.com"
TURBO_TOKEN="your-secret-token"