[Git] Git Pull 실행 시 "Your local changes would be overwritten by merge" 에러 해결 방법

 

 

Git으로 협업을 하다 보면 git pull 명령어를 실행했을 때 "Your local changes to the following files would be overwritten by merge"라는 에러 메시지를 마주할 수 있습니다. 이 에러는 로컬에서 수정한 내용과 원격 저장소의 변경 내용이 충돌하여 발생합니다. 이 글에서는 이 문제의 원인과 다양한 해결 방법을 소개합니다

 

 

에러 메시지 분석

아래는 문제가 발생했을 때의 에러 메시지입니다:

error: Your local changes to the following files would be overwritten by merge:
        server/requirements.txt
Please commit your changes or stash them before you merge.
Aborting

 

이는 pull을 수행할 때 원격 저장소의 변경 내용과 로컬 변경 내용이 충돌이 생겨 발생하는 에러 메시지이며, Git은 충돌을 방지하기 위해 병합을 중단합니다.

 

 

로컬 변경 사항 확인 방법

에러 메시지에 나타나지 않는 변경 파일이 있는지 확인하려면 아래 명령어를 실행하세요:

git status

 

예시 결과:

On branch main
Your branch is behind 'origin/main' by 1 commit, and can be fast-forwarded.
  (use "git pull" to update your local branch)

Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git restore <file>..." to discard changes in working directory)
        modified:   server/requirements.txt
        modified:   another_file.txt

 

modified로 표시된 파일들이 로컬에서 수정된 파일입니다. 이 경우, server/requirements.txt 외에 another_file.txt도 변경되었습니다.

 

 

 

해결 방법

1. 로컬 변경 사항 삭제 (Git 원격 저장소 내용으로 덮어쓰기)

로컬에서 수정한 내용을 유지할 필요가 없다면 아래 명령어를 실행하세요:

git reset --hard HEAD
git pull origin main

 

주의: 이 방법은 로컬에서 수정한 모든 변경 사항을 삭제하므로, 중요한 변경 사항이 있다면 다른 방법을 선택하세요.

---

2. 변경 사항 임시 저장 (Stash 사용)

로컬 변경 사항을 유지하면서 pull을 진행하려면 stash 명령어를 사용하세요:

1. 변경 사항 임시 저장:
2. git stash
3. 최신 내용 pull:
4. git pull origin main
5. 변경 사항 다시 적용:
6. git stash apply

참고:

stash apply 후 충돌이 발생하면 해당 파일을 수동으로 수정한 뒤 git add와 git commit을 실행하세요.

---

3. 변경 사항 커밋 후 Pull

로컬 변경 사항을 커밋하고 pull을 진행할 수도 있습니다:

1. 변경 사항 커밋:
2. git add server/requirements.txt git commit -m "Local changes to requirements.txt"
3. 최신 내용 pull:
4. git pull origin main

충돌 해결:

충돌이 발생하면 Git에서 표시하는 충돌 내용을 수정한 뒤 아래 명령어를 실행하세요:

git add <충돌 수정된 파일>
git commit -m "Resolve merge conflicts"

---

마무리

이 에러는 로컬 변경 사항과 원격 저장소의 변경 내용 간 충돌 때문에 발생합니다. 상황에 따라 변경 사항을 삭제하거나 저장 또는 커밋하여 문제를 해결할 수 있습니다.

요약:

• 변경 사항 삭제: git reset --hard HEAD
• 임시 저장: git stash
• 변경 사항 커밋: git commit

Git을 사용할 때 발생할 수 있는 이러한 문제를 이해하고 해결 방법을 익히면 협업 시 발생할 수 있는 혼란을 줄일 수 있습니다. 앞으로 Git 명령어를 사용할 때, 상황에 맞는 적절한 해결 방법을 선택하세요!