Skip to main content

🧩 Resolving Complex Git Merge Conflicts Locally

⚠️ Problem

When merging a pull request on GitHub, you may encounter:
“These conflicts are too complex to resolve in the web editor.”
This usually means:
  • Large structural differences in files
  • Binary file conflicts
  • Changes scattered across a file
  • Multiple developers editing the same areas

🛠️ Solution: Use Git Locally to Resolve

✅ Step 1: Clone the Repository (if not done already)


🔁 Step 2: Checkout the Base Branch (e.g., main)


🔀 Step 3: Merge the Source Branch (e.g., feature-branch)

If there are conflicts, Git will output which files are conflicting.

🧹 Step 4: Resolve Conflicts Manually

Open the conflicted files in your editor. You’ll see conflict markers like this:
📝 Manually edit the file to keep the correct/combined version. Then save the file.

✅ Step 5: Mark the File as Resolved

Do this for each conflicted file you resolve.

💾 Step 6: Commit the Merge

Git will open the default merge message. You can leave it as-is or edit it.

🚀 Step 7: Push the Changes to GitHub

Now the PR should be marked as merged (or you can close the PR if you’ve pushed directly to main).

🧰 Tips

  • Use git status to see unresolved files.
  • Use GUI tools like VS Code, Sourcetree, or GitKraken if you prefer visual merge tools.
  • For large repos, make a backup branch before merging: