使用repo tool在GitLab中同步私有分支至最新master的最佳实践

针对你从Gerrit切换到GitLab、使用repo工具管理多仓库的场景，下面是同步私有分支与最新master的实操方案，分步骤说明：

一、先同步全局Master分支（Repo层面） #

因为repo是多仓库管理工具，首先要确保本地所有仓库的master分支与GitLab远程保持一致：

• 回到repo根目录，执行repo sync -d：-d参数会强制所有仓库切换到manifest指定的分支（默认是master），拉取远程最新代码并重置本地master，避免本地master存在未提交的修改。
• 若需单独同步某个仓库的master，执行repo sync -b master <仓库相对路径>，指定目标仓库和分支。

二、单仓库私有分支同步（两种主流方式） #

根据你的分支状态（是否已提MR、是否多人协作）选择合适的方式：

方式1：Rebase（推荐用于未提MR/单人开发分支） #

Rebase会将你的私有分支提交“平移”到最新master顶端，保持提交历史线性，更符合GitLab的评审习惯：

1. 进入目标仓库目录：cd <仓库相对路径>
2. 切换到私有分支：git checkout <你的私有分支名>
3. 执行rebase：git rebase master
   • 若出现冲突，Git会标记冲突文件，手动修改后执行git add <冲突文件>，再运行git rebase --continue，直到所有冲突解决。
   • 若要终止rebase，执行git rebase --abort
4. 推送更新后的分支：git push origin <你的私有分支名> --force-with-lease（--force-with-lease比--force更安全，防止意外覆盖他人修改）

方式2：Merge（推荐用于已提MR/多人协作分支） #

Merge会生成一个新的合并提交，保留原有提交历史，适合不想打乱MR评审记录的场景：

1. 进入目标仓库目录并切换到私有分支：cd <仓库相对路径> && git checkout <你的私有分支名>
2. 合并最新master：git merge master（若本地master未同步，先执行git pull origin master）
3. 处理冲突：修改冲突文件后执行git add <冲突文件>，再运行git commit（Git会自动生成合并提交信息，可按需修改）
4. 推送分支：git push origin <你的私有分支名>（无需强制推送，因为是新增提交）

三、Repo批量操作（多仓库同步可选） #

如果多个仓库都有同名私有分支需要同步，可使用repo的批量命令：

• 同步所有仓库的master：repo forall -c 'git checkout master && git pull origin master'
• 批量对所有仓库的私有分支执行rebase：repo forall -c 'git checkout <你的私有分支名> && git rebase master'
  注意：批量操作前请确认各仓库分支状态，避免批量冲突。

四、GitLab MR配合要点 #

• 同步私有分支后，GitLab会自动更新对应MR的内容，无需重新创建MR
• 同步完成后建议触发CI/CD，验证代码在最新master基础上的兼容性
• 若MR包含多个提交，同步后的提交历史会自动同步到MR中，评审者可查看最新修改

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