听起来像是魔法，其实背后是一套成熟的工作流：pnpm workspaces + turborepo + tsconfig path alias。接下来我们就把这套组合拆解成可操作的小步骤。

# 创建空目录并进入
mkdir my-mono && cd my-mono
# 初始化根 package.json
pnpm init -y
jq '.private=true' package.json> tmp && mv tmp package.json

随后在根目录新建 pnpm-workspace.yaml

packages:
  - "apps/*"
  - "packages/*"

my-mono/
├─ apps/                # 各终端入口，仅负责渲染 & 路由
│   ├─ web/             # Next.js / React 项目
│   ├─ mini/            # 微信/支付宝小程序
│   └─ native/          # RN 或 Flutter 项目
├─ packages/            # 可复用层次
│   ├─ ui/              # 跨端 UI 基础组件库
│   ├─ utils/           # 通用工具函数
│   ├─ api/             # 请求封装 & 类型定义
│   └─ core/            # 核心业务模型
└─ turbo.json           # Turborepo 配置文件

原则：

apps → core → ui → utils 的方向永远不反向。

每个子包只Neng访问比自己层级低或相同的包。

尽量让业务代码集中在 packages/core 中，其他层只Zuo包装或适配。

# Turbo 用来Zuo增量构建和缓存加速
pnpm add -Dw turbo
# TypeScript 与 linting
pnpm add -Dw typescript eslint @typescript-eslint/parser @typescript-eslint/eslint-plugin

Turborepo 的配置文件非常简洁：

{
  "$schema": "https://turborepo.org/schema.json",
  "pipeline": {
    "build": {
      "dependsOn": ,
      "outputs": 
    },
    "lint": {
      "outputs": 
    },
    "type-check": {
      "dependsOn": ,
      "outputs": 
    }
  }
}

Turbine 会自动识别各子包中的 "scripts" 字段，只要在对应子包里写好 build / lint / type-check，就Neng享受并行执行与缓存命中率提升的双重福利。

根目录创建 tsconfig.base.json

{
  "compilerOptions": {
    "target": "ES2021",
    “module”: “ESNext”,
    “moduleResolution”: “node”,
    “strict”: true,
    “esModuleInterop”: true,
    “skipLibCheck”: true,
    “forceConsistentCasingInFileNames”: true,
    “baseUrl”: ".",
    “paths”: {
      "@ui/*": ,
      "@utils/*": ,
      "@api/*": ,
      "@core/*": 
    }
  },
  "include": 
}

每个子包只需要在自己的 tsconfig 中 基准：

// packages/ui/tsconfig.json 示例
{
  "extends": "../../tsconfig.base.json",
  "compilerOptions": {
     // 如有额外需求，可覆盖这里
  }
}

A 应用想要使用核心业务函数，只需要这样写：

// apps/web/src/pages/home.tsx
import { fetchUserInfo } from '@core/user';
import { formatDate } from '@utils/date';
export default function Home {
  // …
}

Turborepo 会自动检测到 @core/user 被引用，于是当你修改了 core 包里的类型或实现时只会重新编译受影响的 app，而其他未涉及的 app 完全保持原样。

A) 所有跨端 API 的接口定义放在 /packages/api/types.tsx 中，用 OpenAPI 或 Swagger 自动生成；

B) UI 样式变量 放进统一的 design‑token 包，让 Web 与小程序通过 CSS‑in‑JS 或 less 同步读取。

C) 当业务需求变geng，只需修改这两处，即可让所有终端获得Zui新行为。

不要把所有第三方库dou装在根目录，这会导致每个子包dou有不必要的大体积。Zui佳Zuo法是：

A) 开发工具链 放根目录；

B) 真正运行时需要的库 放在对应子包；

C) 对于跨多个子包共享但体积不大的工具 ，Ke以使用 workspace 协议让它们指向同一个物理位置，从而实现“单例”。

Turborepo 在检测到循环引用时会给出警告，但Ru果不及时处理，会让类型检查崩溃。例如：

packages/core → packages/utils → packages/core 

解决思路：抽离公共类型到Zui底层 (/packages/shared-types）），让其它模块仅依赖该层，而不是互相引用彼此实现。