Git - error : The following untracked working tree files would be overwritten by merge

git status

해당 오류는 Git 병합(merge) 또는 pull을 시도할 때, 추적되지 않은(untracked) 파일이 현재 작업 디렉터리에 존재하며, 병합 과정에서 이 파일들이 덮어씌워질 가능성이 있을 때 발생한다.

 

---

1. 문제 확인

 

1-1 문제 파일 확인

현재 추적되지 않은 파일들을 확인

git status

- untracked files : 현재 git에서 추적되지 않는 파일

 

 

 

---

2. 해결 방법

 

2-1. 파일 유지

추적되지 않은 파일을 Git에 추가하고 병합을 계속 진행

# 1. 파일을 스테이지에 추가
git add <파일명>

# 2. 커밋
git commit -m "Add untracked files"

# 3. 병합 재시도
git merge <브랜치명>

 

 

2-2. 파일 삭제

추적되지 않은 파일이 불필요

# 1. 파일 삭제
rm <파일명>

# 2. 병합 재시도
git merge <브랜치명>

 

 

2-3. 파일 임시 저장

파일을 당장 병합에 포함하지 않고, 이후 가져올 수 있음

# 1. 변경사항과 추적되지 않은 파일을 임시로 저장
git stash -u
# -u 옵션은 추적되지 않은 파일도 스태시에 포함

# 2. 병합 또는 pull 실행
git merge <브랜치명>

# 3. 임시로 저장했던 내용 다시 적용
git stash apply

 

 

---

3. 예방

 

pull 이나 merge 하기 전에 작업 디렉터리를 정리하고 추적되지 않은 파일을 삭제

# 추적되지 않은 파일 확인(clean될 목록) 후 삭제
git clean -n
# -n 옵션은 삭제될 파일 목록만 표시

git clean -f
# -f 옵션은 실제로 삭제

 

 

끝.