如何实现Git仓库分支的部分镜像同步，避免文件冲突？

可以实现两个仓库间共同文件的自动同步，且不会因独有文件产生冲突，以下是几种实用方案：

方案一：Git Subtree（推荐，适合轻量同步场景） #

这种方式通过目录级同步实现共享文件的双向更新，建议先调整目录结构简化操作：

1. 调整目录结构
   将两个仓库中的a.py、b.py、c.py统一移到shared/子目录，保留各自独有文件在根目录：

   repo a/main
   ├── shared/
   │   ├── a.py
   │   ├── b.py
   │   └── c.py
   └── x.py
   
   repo b/main
   ├── shared/
   │   ├── a.py
   │   ├── b.py
   │   └── c.py
   └── y.py
   

2. 配置双向同步

   • 在repo a中添加repo b为远程仓库：

     git remote add repo-b <repo-b的Git仓库地址>
     

   • 拉取repo b的shared目录到本地：

     git subtree pull --prefix shared repo-b main --squash
     

   • 修改repo a的shared目录文件后，推送到repo b：

     git subtree push --prefix shared repo-b main
     

   • 反之，repo b修改后也可执行相同步骤同步到repo a。

3. 自动化同步
   在GitLab CI/CD中配置流水线，当shared目录有变更时自动触发推送：

   sync-shared-to-repo-b:
     stage: deploy
     only:
       changes:
         - shared/**/*
     script:
       - git remote add repo-b https://gitlab-ci-token:$CI_JOB_TOKEN@<repo-b的Git地址>
       - git subtree push --prefix shared repo-b main
   

方案二：GitLab CI/CD 直接同步指定文件 #

无需调整目录结构，通过脚本精准同步目标文件：

1. 在repo a中配置CI/CD流水线
   创建.gitlab-ci.yml文件，设置当a.py、b.py、c.py变更时自动同步到repo b：

   sync-shared-files:
     stage: deploy
     only:
       changes:
         - a.py
         - b.py
         - c.py
     script:
       # 克隆repo b
       - git clone https://gitlab-ci-token:$CI_JOB_TOKEN@<repo-b的Git地址> repo-b
       # 复制共享文件
       - cp a.py b.py c.py repo-b/
       # 提交并推送
       - cd repo-b
       - git config user.name "GitLab CI/CD"
       - git config user.email "ci@your-domain.com"
       - git add a.py b.py c.py
       - git commit -m "Sync shared files from repo a" || echo "No changes to commit"
       - git push origin main
   

2. 反向同步配置
   在repo b中创建相同逻辑的CI/CD任务，实现双向自动同步。

方案三：Git Submodule（适合复杂依赖场景） #

通过独立的共享仓库管理共同文件，版本控制更清晰：

1. 创建共享仓库
   新建repo-shared仓库，将a.py、b.py、c.py迁入并推送。

2. 在repo a和repo b中添加子模块

   • 在repo a中执行：

     git submodule add <repo-shared的Git地址> shared
     git commit -m "Add shared submodule"
     git push origin main
     

   • repo b执行相同步骤。

3. 同步更新
   当repo-shared有变更时，在repo a/b中执行以下命令拉取最新版本：

   git submodule update --remote
   

   也可通过CI/CD自动触发该命令完成更新。

注意事项 #

• 独有文件x.py（repo a）、y.py（repo b）仅在各自仓库修改，避免同步时出现覆盖或冲突。
• CI/CD任务需配置足够权限（如GitLab部署令牌），确保能访问目标仓库。
• 使用Subtree或Submodule时，需确保团队成员熟悉相关操作流程。

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