Git Merge Conflicts for Beginners - What to Do When Your Branches Have Beef

Wait, What Even Is git merge?#

Here’s the deal. When you work on a project, you create branches, which are basically parallel universes for your code. Whatever you want to try, you try it in your own branch, no harm to the main project. It’s your personal creative space.

And git merge is the command that drags your little universe back into the main timeline.

For example:

1
git checkout main
2
git merge feature/new-login

That’s literally you telling Git, “Hey, take all the awesome stuff I built in feature/new-login and add it to the main branch, please!”

When It’s a Buttery-Smooth Ride#

1
git merge --no-ff feature/new-login

When Git Has a Meltdown (aka a Conflict)#

So here’s where the drama starts. A conflict pops up when you and someone else (or, honestly, past-you on a different branch) edited the exact same line of code in two different ways. Git gets overwhelmed. It stares at both versions and just cannot pick a winner. It’s basically looking at you like, “OMG, girl, I can’t decide. You have to choose!”

What This Hot Mess Looks Like in Your Code#

You open the file, and boom — Git greets you with something like this:

1
<<<<<<< HEAD
2
The version of the code from the main branch
3
=======
4
The version of the code from your new feature/new-login branch
5
>>>>>>> feature/new-login

Don’t panic!

This isn’t an error. It’s Git’s way of saying:

“Hey, I found two different versions of this code and I don’t know which one to keep. Can you help me out?”

Those weird lines actually mean something. Here’s the breakdown:

• <<<<<<< HEAD - This is what’s currently in your main branch.
• ======= - This line separates the two versions.
• >>>>>>> feature/new-login - And this is the version coming from your branch.

Okay, So How Do I Fix This? A Step-by-Step Guide!#

1. Breathe! You’ve got this.
2. Analyze the code. Take a look at both versions. Which one do you need? Maybe you need a little bit of both? The final decision is all yours.
3. Edit the file. Just delete the code you don’t want and leave only the code that should be there.
4. Delete the markers. You have to get rid of the <<<<<<<, =======, and >>>>>>> lines. They’ve served their purpose.
5. Save the file.

And that’s it! The conflict in the code is officially resolved.

The Final Steps: Letting Git Know You’re a Genius#

Now you just have to tell Git you’ve handled it and everything is okay:

Tell Git you’ve resolved the conflict in this file

1
git add <filename>

Finalize the merge with a commit

1
git commit

Git usually pops up a pre-written commit message for you. Honestly? Just use that one. No notes.

And you’re done! The merge is complete, and your amazing new feature is safe and sound in the main branch! 🎉

SOS! What If I Messed Everything Up?#

Maybe you started fixing a conflict and suddenly realized you’re in way over your head. Don’t worry, sis. There’s an escape button:

1
git merge --abort

This one cancels the merge completely, like it never even happened. Your project snaps right back to how it was before you started. Take a breath. Try again when you’re ready.

How to Vibe with merge and Avoid Conflicts#

• Always stay updated! Before you start a new feature, update your main branch first. The safest move is a little two-step: run git fetch (this just downloads the latest changes without touching your code) and then git merge origin/main (this applies those changes). It seriously lowers your odds of a conflict.
• Stay in your own lane. When you can, try to work on different files than your teammates.
• Communicate! This is the big one, queen. Actually talk to your team about who’s working on what. A good convo is the secret to a conflict-free life.

The Takeaway#

Git conflicts are not the end of the world. They’re normal. Super normal. They don’t mean you’re a bad developer, not even a little. It’s literally just Git going, “Hey! I’ve got two different things here—can you help me choose?”

And now? You know exactly how to help. You’re already one step closer to feeling like a total pro in Git.

Keep coding, girl! You’re killing it! 💖