---

title: Git 子模块与 Monorepo 管理指南

keywords:

• Git
• Monorepo
• 子模块
• 子树
• 依赖管理

description: 对比子模块与 Monorepo 的适用性与操作流程，提供可执行的命令清单。

categories:

• 文章资讯
• 技术教程

---

Git 子模块与 Monorepo 管理指南

场景选择

• 子模块：外部独立仓库作为依赖，保持分发边界清晰
• Monorepo：统一版本、统一工具链，适合多包协同开发

子模块基础操作

git submodule add https://example.com/vendor/lib.git libs/lib
git submodule update --init --recursive
git submodule foreach git pull origin main

子树替代方案

git subtree add --prefix=libs/lib https://example.com/vendor/lib.git main --squash
git subtree pull --prefix=libs/lib https://example.com/vendor/lib.git main --squash

Monorepo 建议

• 使用工作空间管理工具统一脚本与依赖
• 规范包间接口，避免隐式耦合
• 引入持续集成进行分包选择性构建与测试

版本与发布

• 语义化版本与变更日志
• 可选择独立发布或整体发布策略

总结

根据团队规模与协作特点选择合适的仓库结构，并保持操作流程清晰与自动化程度。