monorepo的使用

代码复用与共享
所有子模块（如组件库、工具函数）集中管理，支持跨项目直接引用，避免重复开发。例如，业务模块可共享全局组件库和工具函数，无需通过 npm 包发布更新2 15。
统一构建与依赖管理
通过单一仓库统一配置构建工具（如 Webpack、Vite）、代码规范（ESLint/Prettier）和 CI/CD 流程，减少重复配置。例如，使用 pnpm-workspace 自动同步依赖版本15 24。
高效协作与调试
所有项目代码在本地可见，支持跨模块实时联调，无需通过 npm link 或版本发布验证改动，提升开发效率33。
依赖优化与存储节省
pnpm 通过硬链接和符号链接技术减少 node_modules 重复安装，降低磁盘占用，同时解决“幽灵依赖”问题15 24。

工具	特点	适用场景	参考
pnpm	轻量级，内置 Workspace 模式，依赖管理高效，适合中小型项目	快速搭建、轻量级 Monorepo	15 33
Turborepo	并行构建与缓存优化，显著提升构建速度，支持增量发布	大型项目性能优化	24
Nx	企业级工具链，支持 Angular/React 等，提供智能构建、分布式任务管理	复杂工程与团队协作
Lerna	传统 Monorepo 方案，支持版本发布自动化，但依赖管理需结合 Yarn/pnpm	已有项目迁移至 Monorepo

初始化项目结构

示例结构：

复制代码

monorepo/
├── apps/           # 业务应用
├── packages/       # 共享模块（组件、工具）
└── pnpm-workspace.yaml

依赖管理与安装
- 使用 pnpm add <package> -w 安装全局依赖，--filter 指定子模块安装33。
- 示例：pnpm add vue -w --filter @project/utils。
子模块互通与构建
- 在 packages/components 中导出组件，通过 "@project/components": "workspace:*" 声明依赖33。
- 使用 Turborepo 配置并行构建任务（如 build、test）加速流程24。

目录规范与权限管理
- 按业务域划分目录（如 apps/crm、packages/shared），结合 Git 钩子控制文件读写权限，避免误操作核心代码12 24。
- 使用 GitLab 分支保护规则，限制 main 分支直接推送，强制 Code Review12。
版本控制与发布
- 采用 Changesets 或 Lerna 自动化版本号升级与 CHANGELOG 生成，确保多包版本一致性24。
- 避免直接修改 package.json 版本，通过工具批量管理。
性能优化
- 启用 Turborepo 远程缓存（如 Vercel、本地 NAS），减少 CI/CD 重复构建24。
- 按需构建：仅对改动模块及其依赖执行构建。

幽灵依赖（Phantom Dependencies）
现象：子模块未声明依赖却可访问。
解决：使用 pnpm 严格模式（node-linker=isolated）隔离依赖15。
依赖安装耗时
优化：通过 .npmrc 配置公共依赖提升至根目录，减少冗余安装15 24。
权限冲突
方案：结合 GitLab 的 Protected Environments 限制目录写入权限，例如禁止非 Maintainer 修改核心模块12。

Monorepo 是管理复杂前端工程的理想方案，工具链选择需结合项目规模：

评论