Git Monorepo多项目：如何单独克隆子项目并推送？是否仅用Submodule？

你的需求是搭建一个名为monorepo的伞形仓库，内部包含project1_repo、project2_repo、project3_repo三个子项目，支持单独克隆单个子项目并直接执行git push，无需克隆整个Monorepo。以下是可行方案，Git Submodule并非唯一选择：

1. Git Submodule（经典独立子仓库方案） #

每个子项目都是独立的Git仓库，Monorepo仅记录子项目的版本快照。

• 初始化步骤：在Monorepo根目录执行

  git submodule add <project1仓库地址> project1_repo
  git submodule add <project2仓库地址> project2_repo
  git submodule add <project3仓库地址> project3_repo
  

• 独立克隆子项目：用户直接克隆子项目的独立仓库即可，比如：

  git clone <project2仓库地址>
  

  修改后正常执行git add、git commit、git push，Monorepo端可通过git submodule update --remote拉取子项目最新版本。
• 优劣分析：
  • 优势：子项目完全独立，权限、发布周期可单独管理；Monorepo体积小，仅存版本引用。
  • 劣势：新手易混淆子模块操作（需额外执行submodule init、submodule update）；Monorepo提交时需同步子项目的版本更新。

2. Git Subtree（更易用的独立子仓库方案） #

将子项目仓库作为Monorepo的子目录，同时保留子项目的独立Git历史，用户操作子项目和普通Git仓库无差异。

• 初始化步骤：在Monorepo根目录执行

  git remote add project2_remote <project2仓库地址>
  git subtree add --prefix=project2_repo project2_remote main
  

• 独立克隆子项目：直接克隆子项目的独立仓库，修改后正常push即可。
• 同步操作：
  • 从子项目拉取最新代码到Monorepo：

    git subtree pull --prefix=project2_repo project2_remote main
    

  • 将Monorepo中子项目的修改推送到独立仓库：

    git subtree push --prefix=project2_repo project2_remote main
    

• 优劣分析：
  • 优势：用户操作无额外学习成本；Monorepo可直接修改子项目内容并推送到独立仓库。
  • 劣势：Monorepo会包含子项目的所有提交历史，体积可能增大；同步命令相对冗长。

3. Git sparse-checkout（轻量单仓库方案） #

如果子项目无需独立仓库，仅需减少克隆体积，可使用该方案让用户只克隆Monorepo中的指定子目录。

• 克隆指定子项目：

  git clone --filter=blob:none --sparse <monorepo仓库地址>
  cd monorepo
  git sparse-checkout set project2_repo
  

• 修改与推送：修改后直接执行git push到Monorepo即可，无需额外操作。
• 优劣分析：
  • 优势：无需维护多个独立仓库；克隆仅拉取指定子目录，节省空间。
  • 劣势：子项目无独立仓库地址，依赖Monorepo存在；权限管理针对整个Monorepo，无法单独对子项目授权。

方案选择建议 #

• 若子项目需要完全独立的仓库、权限和发布周期，Git Subtree是更友好的选择（比Submodule易用），Submodule适合对Git操作熟悉的团队。
• 若子项目无需独立仓库，仅需轻量化克隆，Git sparse-checkout是最优解。

Git Submodule并非唯一可行方案，上述三种方式均可满足你的需求，具体取决于子项目的独立性要求和团队的使用习惯。

内容的提问来源于stack exchange，提问作者yk28