Git Checkout 충돌 해결: 유실을 감수하는 방법 vs 안전한 방법

Git을 사용하시다 보면 브랜치를 전환하려 할 때, 아래와 같은 에러 메시지를 마주하실 수 있습니다:

error: Your local changes to the following files would be overwritten by checkout:
    some/file.txt
Please commit your changes or stash them before you switch branches.

이 메시지는 로컬에서 수정한 파일이 전환하려는 브랜치에서도 변경되어 있어서, Git이 해당 파일의 변경사항을 잃지 않도록 막고 있다는 의미입니다.

하지만 때로는 해당 변경사항이 불필요하거나 유실되어도 괜찮은 경우가 있고, 반대로 절대로 놓치고 싶지 않은 중요한 작업일 수도 있습니다. 이 글에서는 두 경우 모두를 안전하게 처리하는 방법을 정리해 드립니다.

---

✅ 변경사항 유실을 감수하고 강제로 브랜치 전환하기

로컬 작업이 사라져도 괜찮으시다면 -f 플래그를 사용하여 강제로 브랜치를 전환하실 수 있습니다:

git checkout -f 브랜치명

예:

git checkout -f main

이 명령을 실행하면 로컬에서 수정한 내용은 모두 삭제되며, 지정한 브랜치로 전환됩니다.

또는, 원격 브랜치 기준으로 강제 리셋도 가능합니다:

git fetch origin
git reset --hard origin/브랜치명

예:

git reset --hard origin/main

이 명령은 현재 브랜치의 내용을 원격 저장소 상태로 완전히 덮어씁니다.

⚠️ 주의: 이 명령은 git log의 커밋 히스토리까지 바꿔버리기 때문에, 정말 필요할 때만 사용하시는 것이 좋습니다.

---

🔒 변경사항을 안전하게 보존하면서 브랜치 전환하기

1. 스테이징 또는 커밋하기

변경사항을 유지하고 싶으시다면, 커밋을 만들거나 일단 스테이징이라도 해 두는 것이 좋습니다.

git add .
git commit -m "WIP: 현재 작업 백업"

이렇게 하면 작업 내역이 기록되므로, 나중에 되돌리기 쉽습니다.

2. Stash를 사용하여 임시 저장하기

작업 중인 내용을 임시로 보관한 뒤, 브랜치를 전환하고 다시 꺼낼 수도 있습니다.

git stash

그 후:

git checkout 브랜치명
git stash pop  # 다시 꺼내오기

여러 개의 stash를 저장하고, 리스트에서 선택하여 복원하는 것도 가능합니다:

git stash list
git stash apply stash@{1}

---

🧭 요약

상황 해결 방법

변경사항 유실 괜찮음	git checkout -f 브랜치명 또는 git reset --hard
변경사항 유지 원함	git commit 또는 git stash 활용

---

Git은 협업을 위한 도구인 만큼, 조심스러운 작업일수록 더 많은 안전장치를 제공합니다. 급할 때는 -f나 --hard가 도움이 될 수 있지만, 가능한 한 stash나 commit을 활용하여 안전하게 브랜치를 전환하는 습관을 들이시기 바랍니다.