如何用Git构建仓库层级？将多独立子仓库合并为Tharwa父仓库

这简直是Git子模块的完美应用场景！正好能满足你既要保持每个子仓库的独立性（不混淆依赖、提交记录），又能在父仓库Tharwa中统一管理、关联开展工作的需求。

核心原理 #

Git子模块允许父仓库引用其他独立Git仓库的特定提交版本，每个子仓库依然是完全独立的：拥有自己的提交历史、依赖配置，同时父仓库可以追踪子仓库的版本变化，需要时能直接在父仓库的上下文里操作子仓库的代码。

具体操作步骤 #

1. 初始化父仓库Tharwa
   首先创建并初始化你的整合仓库：

mkdir Tharwa && cd Tharwa
git init

2. 添加子仓库作为子模块
   针对每个独立的子仓库，使用git submodule add命令将其关联到父仓库。你可以用本地路径或者远程Git仓库地址：

# 例子：添加本地的projectA子仓库，在Tharwa中生成projectA文件夹
git submodule add ../projectA projectA

# 或者添加远程仓库
git submodule add git@github.com:xxx/projectB.git projectB

执行后，父仓库会生成一个.gitmodules文件，记录所有子模块的路径和对应仓库地址，而每个子文件夹依然是独立的Git仓库，完全保留自己的提交历史和配置。

3. 提交父仓库的关联变更
   把.gitmodules文件和子模块的引用提交到父仓库：

git add .gitmodules projectA projectB # 替换成你的子模块文件夹名
git commit -m "Add projectA and projectB as submodules"

日常使用要点 #

• 克隆父仓库时拉取子模块
  其他人克隆Tharwa仓库时，需要加上--recurse-submodules参数才能同时拉取所有子仓库的代码：

git clone --recurse-submodules <Tharwa的Git地址>

如果已经克隆了父仓库，也可以手动初始化并拉取子模块：

git submodule init
git submodule update

• 在子仓库中开展父相关工作
  当需要修改子仓库来解决父仓库的问题时，直接进入子模块文件夹，像操作普通Git仓库一样提交、推送：

cd projectA
# 编写代码、修复问题
git add .
git commit -m "Fix issue #123 related to Tharwa integration"
git push origin main

回到父仓库后，需要提交子模块的最新版本引用，这样父仓库就会记录这次子模块的更新：

cd ..
git add projectA
git commit -m "Update projectA to latest commit for issue #123"

• 保持子仓库独立性
  子仓库的依赖、配置文件完全不会和父仓库混淆，因为每个子模块都是独立的Git环境，你可以在子模块里单独安装依赖、运行脚本，和之前的独立仓库使用方式完全一致。

备选方案：Git Subtree（适合特殊场景） #

如果你偶尔需要把子仓库的代码合并到父仓库（比如需要统一构建），可以考虑Git Subtree，但它会将子仓库的提交历史合并到父仓库，不符合你“不想混淆提交记录”的核心需求，所以更推荐子模块方案。

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