Solving the Dilemma: When Your Branch and origin/master Have Diverged - A Comprehensive Guide

Working with Git branches is essential when collaborating on a project. However, occasionally, you may encounter the dreaded "diverged branches" issue. This comprehensive guide will walk you through the process of resolving this dilemma and ensure your branches are back in sync.

Table of Contents

Understanding the Diverged Branches Issue

Diverged branches occur when your local branch and the remote 'origin/master' have both been updated separately. This can happen if you've made changes to your branch while someone else has pushed updates to the 'origin/master'. In this situation, Git will not allow you to push your changes, as it cannot automatically merge the two branches.

Step-by-Step Solution

Follow these steps to resolve the diverged branches issue and get your branches back in sync.

Step 1: Stash Your Changes

Before starting the process, you should stash any uncommitted changes you have made in your working directory. This ensures that you don't lose any work during the process.

git stash

Step 2: Checkout 'origin/master'

Switch to the 'origin/master' branch:

git checkout origin/master

Step 3: Update Your Local 'master' Branch

Fetch the latest changes from the remote repository and fast-forward your local 'master' branch:

git fetch
git merge origin/master

Step 4: Merge 'origin/master' into Your Feature Branch

Switch back to your feature branch and merge the updated 'origin/master' into it:

git checkout <your-feature-branch>
git merge origin/master

Step 5: Resolve Merge Conflicts

If there are any merge conflicts, Git will notify you. Open the affected files and resolve the conflicts. Once you're done, commit the changes:

git add <conflicted-files>
git commit -m "Resolved merge conflicts"

Step 6: Apply Your Stashed Changes

Now that your branches are in sync, apply your stashed changes:

git stash apply

Resolve any conflicts that may arise and commit the changes:

git add <conflicted-files>
git commit -m "Applied stashed changes"

Step 7: Push Your Changes

Finally, push your changes to the remote repository:

git push

Your branches should now be in sync.


1. What does it mean when Git says my branch and 'origin/master' have diverged?

It means that your local branch and the remote 'origin/master' branch have been updated separately, and Git cannot automatically merge them.

2. How do I know if my branches have diverged?

When you try to push your changes, Git will notify you that your branches have diverged and prevent you from pushing.

3. Can I still push my changes if my branches have diverged?

No, you need to resolve the diverged branches issue first by following the steps outlined in this guide.

4. What happens if I have uncommitted changes when my branches diverge?

You should stash your uncommitted changes before starting the process to ensure you don't lose any work.

5. How can I prevent my branches from diverging in the future?

To minimize the chances of your branches diverging, always ensure that you fetch and merge the latest changes from the remote repository before starting any work on your local branch.

Great! You’ve successfully signed up.

Welcome back! You've successfully signed in.

You've successfully subscribed to

Success! Check your email for magic link to sign-in.

Success! Your billing info has been updated.

Your billing was not updated.