Git 충돌 해결

🚨 ERROR MESSAGE
The following untracked working tree files would be overwritten by merge [file name]

⚠️ 문제 상황

최근 프로젝트를 Git에 업로드하는 중 다음과 같은 에러 메시지를 만났다.

error: The following untracked working tree files would be overwritten by merge:
        README.md
Please move or remove them before you merge.
Aborting

이 오류는 git pull 명령어를 실행할 때 나타났는데, 해석하자면 로컬에 있는 변경되지 않은 파일들이 리모트 저장소에서의 병합 과정에서 덮어쓰여질 것이라는 경고를 의미했다.

이 경고를 무시하고 git add 등의 명령어를 썼다간 아래와 같이 수많은 warning 메시지들이 도배한다.

---

🤔 원인

이 오류는 리모트 저장소와 로컬 저장소의 변경 사항이 충돌할 때 발생한다. 더 구체적인 이유로는 이렇다.

1. 추적되지 않은 파일: 로컬에서 Git에 의해 추적되지 않는 파일들이 있고, 이러한 파일들이 리모트 저장소의 변경 사항과 충돌하고 있는 경우

2. 병합 과정에서의 파일 덮어쓰기: 리모트 저장소에서의 변경 사항이 로컬 파일에 영향을 미치는 경우

---

🔧 해결 방법

1. 파일 백업

충돌을 해결하기 전에 현재 작업 중인 파일들을 안전하게 백업한다. 변경 사항이 손실되지 않도록, 해당 파일들을 다른 디렉토리로 이동하거나 복사하면 된다.

mkdir backup
cp README.md backup/README.md

2. 변경 사항 스테이징 및 커밋

로컬에서 수정한 파일이 있다면, 이를 스테이징하고 커밋하여 Git의 변경 사항으로 기록한다. 변경 사항을 스테이징하고 커밋하는 과정은 다음과 같다.

git add .
git commit -m "Save changes before resolving merge conflict"

3. 충돌 파일 삭제 또는 이동

리모트 저장소와의 병합 충돌을 방지하기 위해, 충돌이 발생한 파일들을 삭제하거나 다른 위치로 이동한다.

rm README.md

또는

mv README.md backup/README.md

4. 리모트 저장소에서 변경 사항 가져오기

충돌 파일을 처리한 후, 리모트 저장소에서 변경 사항을 가져와 병합을 시도합니다.

git pull origin main

5. 파일 복구 및 최종 확인

리모트 저장소의 변경 사항을 병합한 후, 필요 시 파일을 복구한다.

mv backup/README.md .

또는

git checkout -- README.md

복구된 파일을 검토하여 충돌이 해결되었는지 확인한다.

6. 충돌 해결 후 커밋

충돌이 해결된 후, 파일을 수정하고 병합 결과를 커밋한다.

git add .
git commit -m "Resolve merge conflict and recover README.md"

🔄️ 해결 과정

1. 파일 백업: README.md 파일을 backup 디렉토리로 이동.
2. 커밋: 로컬 변경 사항을 커밋.
3. 파일 삭제: 충돌 파일 삭제.
4. 커밋: 충돌 해결 후 최종 커밋.

---

✈️ 마치며

복잡해 보이지만 README처럼 비교적 중요하지 않은 파일이라면 그냥 삭제 후 커밋하면 된다. 그러나 만약 중요한 파일이라면, 위 과정을 따라 파일의 손실을 방지하기 위해 반드시 파일을 백업해야 한다.