monorepo-setup-guide

准备阶段： 1. 明确 Monorepo 的目标与范围：确定哪些项目或模块需要纳入 Monorepo，评估现有代码库的依赖关系、构建流程和团队协作方式。 2. 选择 Monorepo 工具：根据技术栈选择合适的工具，如 pnpm workspace、Yarn workspace、Turborepo、Nx 或 Lerna。 3. 规划目录结构：设计统一的代码组织结构，例如按功能模块划分（packages/、apps/）、共享工具库位置等。 4. 备份现有项目：对即将迁移的项目进行完整备份，确保可回滚。 执行阶段： 5. 初始化 Monorepo 根目录：创建新项目根目录，初始化 package.json，配置 workspaces 字段（如使用 pnpm/Yarn）。 6. 迁移子项目：将各项目按规划结构移动到对应子目录中，保留原有 package.json 并调整依赖路径。 7. 统一依赖管理：在根目录安装公共依赖（如 TypeScript、ESLint），子项目按需继承或覆盖配置。 8. 配置构建与脚本：设置统一的构建命令（如 build、test、lint），利用工具链实现跨包任务编排与缓存优化。 9. 配置版本与发布流程（可选）：若需独立发布子包，配置 publishConfig 和版本管理策略（如 changesets）。 10. 集成 Git 工作流：配置 .gitignore、提交规范（如 Conventional Commits），设置分支策略与 PR 模板。 自检阶段： 11. 验证依赖解析：运行 install 命令，确认各子包能正确识别本地依赖与外部依赖。 12. 测试构建流程：执行根目录的构建脚本，检查所有子项目能否成功编译且无路径错误。 13. 运行测试套件：确保单元测试、集成测试在 Monorepo 环境下正常执行。 14. 检查开发体验：验证热重载、类型检查、代码跳转等功能在 IDE 中是否正常工作。 15. 团队验证：邀请团队成员克隆仓库，完成安装、开发、提交全流程测试，收集反馈并优化配置。

存档时间线

版本索引永久保留；内容副本只保留最新 1 份，更早版本仅留索引与哈希（存档时间线的证据链不会因此断裂）。

下载存档内容副本