如何用Git管理嵌套关联仓库：双向同步历史且不改动工作树

目录结构 #

upper
├── left
└── right

核心需求 #

• upper、left、right各自作为独立Git仓库
• left和right的提交历史可同步到upper仓库
• upper的提交历史可同步到left和right仓库
• 同步操作最好不改动对应工作树

预期工作流程 #

1. 在left目录开发并提交到远程裸仓库left.git
2. 将left.git的提交历史同步到upper.git
3. 在upper目录开发（包含right目录文件）并提交到upper.git
4. 将upper.git中right相关的提交历史同步到right.git

遇到的问题 #

尝试使用git subtree方案时，执行以下命令：

git subtree -P left add <left.git> master

出现报错：

fatal: prefix 'left' already exists.

解决方案 #

1. 初始化upper仓库的正确步骤 #

由于upper目录下已存在left和right目录，无法直接用git subtree add（该命令会创建指定前缀目录），需改用git subtree pull关联已存在的目录：

• 先初始化upper为Git仓库并提交现有文件：

  cd upper
  git init
  git add .
  git commit -m "initial commit with left and right directories"
  git remote add upper <upper.git>
  git push upper master
  

• 关联left仓库到upper的left目录：

  git remote add left <left.git>
  git subtree pull -P left left master --squash
  

  （--squash会将left的提交合并为一个提交，避免upper历史过于繁杂；若需保留完整提交历史，可去掉该参数）

2. 从left同步到upper的操作 #

当left仓库有新提交时，在upper仓库执行：

git subtree pull -P left left master --squash
git push upper master

3. 从upper同步到left的操作 #

当upper仓库中left目录有新提交时，在upper仓库执行：

git subtree push -P left left master

4. right仓库的同步操作 #

right仓库的关联和同步逻辑与left完全一致，只需将命令中的left替换为right即可。

关于git submodules的补充 #

若subtree方式不符合预期，可考虑git submodules：submodules会在仓库生成.gitmodules配置文件，同步时需单独拉取子模块，适合对仓库独立性要求更高的场景；而subtree的优势是无需额外配置文件，子目录与主仓库的提交融合度更高。

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