Git中在已有Feature分支推送新提交并同步Master分支的最佳方法

你当前的场景是：本地feature分支有未提交修改，同时远程的master和feature分支都有其他人的新提交，需要同步master分支更新且保持与远程feature分支一致，下面先分析你的两个选项，再给出更优的操作方法。

你的现有选项分析 #

Option 1 #

# 本地feature分支有未提交修改
git stash save -u "new commit"
git pull  # 拉取远程feature分支的新提交（等价于git fetch origin + git merge origin/feature）
git pull origin master  # 拉取远程master并合并到本地feature
git stash pop
git push

问题：两次pull会生成两个无意义的合并提交，导致Git提交历史变得混乱分叉，后期回溯提交会非常麻烦，不推荐使用。

Option 2 #

# 本地feature分支有未提交修改
git pull --rebase  # 拉取远程feature并变基（将本地feature的提交移到远程feature最新提交之后）
git pull origin master  # 合并远程master到本地feature
git push

问题：虽然用--rebase让feature分支历史更线性，但后续合并master还是会产生一个合并提交，步骤冗余，不是最优方案。

推荐的两种最优方法 #

方法一：合并Master分支到Feature（保留合并历史，适合多人协作分支） #

这种方式不会改写提交历史，适合团队要求保留分支合并轨迹的场景：

1. 确保当前在feature分支：git checkout feature
2. 暂存本地未提交的修改（包含未跟踪文件）：

   git stash save -u "暂存本地未提交修改"
   

3. 拉取远程所有分支的最新状态（先同步远程信息，避免合并过时内容）：

   git fetch origin
   

4. 同步远程feature分支的最新提交：

   git merge origin/feature
   

5. 合并远程master分支的最新提交到本地feature：

   git merge origin/master
   

6. 如果出现冲突，手动解决冲突后，提交合并结果：

   git add .
   git commit  # Git会自动生成合并提交信息，可按需修改
   

7. 恢复之前暂存的本地修改：

   git stash pop
   

8. 提交本地修改并推送到远程feature：

   git add .
   git commit -m "feat: 描述你的本地修改内容"
   git push origin feature
   

方法二：变基Feature分支到Master（线性干净历史，适合个人/小团队分支） #

如果你的feature分支仅自己维护，或团队允许改写公共分支历史，变基能让提交历史更简洁线性：

1. 确保当前在feature分支：git checkout feature
2. 暂存本地未提交的修改：

   git stash save -u "暂存本地未提交修改"
   

3. 拉取远程所有分支的最新状态：

   git fetch origin
   

4. 同步远程feature分支的最新提交：

   git merge origin/feature
   

5. 将本地feature分支变基到远程master的最新提交（把feature的所有提交移到master最新提交之后）：

   git rebase origin/master
   

6. 若变基过程中出现冲突：
   • 手动解决冲突后，执行git add .
   • 继续变基：git rebase --continue
   • 若要跳过当前冲突提交：git rebase --skip
   • 若要放弃变基：git rebase --abort
7. 恢复本地暂存的修改：

   git stash pop
   

8. 提交本地修改并推送（因为变基改写了历史，需要用--force-with-lease安全强制推送，避免覆盖队友的新提交）：

   git add .
   git commit -m "feat: 描述你的本地修改内容"
   git push origin feature --force-with-lease
   

额外注意事项 #

• 优先用git fetch代替直接git pull，可以先查看远程分支的变化，避免意外合并。
• 多人协作的公共feature分支，尽量使用合并的方式，变基公共分支可能导致队友本地分支出现冲突，需要重新同步。
• 新版Git推荐用git stash push -m "暂存消息"代替git stash save，功能更灵活。

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