(1분 읽기) Git 에러 해결: 브랜치 전환 중 충돌! 😱💻The following untracked working tree files would be overwritten by checkout

😱 문제 상황

브랜치를 전환하려는데 다음과 같은 에러가 떴다고?

error: The following untracked working tree files would be overwritten by checkout:
<파일 목록>
Please move or remove them before you switch branches.
Aborting

Git이 추적하지 않는 작업 트리의 파일이 브랜치 전환 중 덮어쓰기될 위험이 있어서 발생한 오류야.
당황하지 말고 아래 방법으로 해결해보자! 🚀

---

🔍 원인

• Git이 추적하지 않는 파일과 브랜치 전환 시 덮어쓰기 위험이 있는 파일이 충돌해서 발생한 오류야.
• 보통 새 파일을 추가했거나, .gitignore에 포함되지 않은 파일이 있을 때 발생해.

---

🛠️ 해결 방법

1️⃣ 변경 사항 임시 저장 (✨추천✨)

• 안전하게 작업 내용을 임시 저장하고 브랜치를 전환해보자.

git stash                # 현재 변경 사항 임시 저장
git checkout main        # 브랜치 전환
git stash pop            # 임시 저장된 내용 복원

 

• git stash: 현재 변경 내용을 임시 저장해.
• git stash pop: 저장해 둔 변경 사항을 다시 적용해줘.
• 장점: 코드가 보존되면서 충돌 없이 브랜치 전환 가능!
• 이 방법이 가장 안전하고 추천하는 방법이야! 👍

---

2️⃣ 추적되지 않은 파일 삭제 (❗신중❗)

• Git에서 추적하지 않는 파일들을 삭제하고 전환해보자.
• 중요 파일은 미리 백업해두는 걸 잊지 마!

git clean -fd            # 추적되지 않은 파일 삭제
git checkout main        # 브랜치 전환

 

• git clean -fd:
  • -f: 강제 삭제
  • -d: 디렉터리도 포함해서 삭제
• 주의: 삭제된 파일은 복구 불가하니, 반드시 백업하고 사용해! 🔥

---

3️⃣ 강제 전환 (❗주의❗)

• 변경 사항을 무시하고 강제로 브랜치를 전환해.
• 변경 내용이 모두 삭제되니 신중히 사용해야 해!

git checkout -f main     # 강제 전환

 

• -f 옵션으로 변경 사항을 무시하고 강제로 체크아웃해.
• 주의: 모든 변경 사항이 삭제되니, 신중하게 사용해야 해! 🔥

 

 

---

💻 안드로이드 스튜디오에서 해결하기

• Android Studio에서 해결할 때는 Version Control 메뉴를 사용해보자.

1. Version Control → Local Changes에서 변경 내용 확인
2. Git → Stash Changes로 임시 저장
3. 브랜치 전환 후 Git → Unstash Changes로 복원

• Tip: 안드로이드 스튜디오에서는 UI로 쉽게 해결할 수 있어!

---

💡 Tip

• git stash를 자주 사용하면 안전하게 브랜치를 전환할 수 있어!
• .gitignore에 불필요한 파일을 추가해서 이런 문제를 미리 예방하자!
• 강제 전환은 마지막 비상수단으로만 사용해! 🔥

---

🚀 이제 Git 충돌도 걱정 끝! 😊

• 브랜치 전환 중에 생기는 충돌도 해결하고,
• 안전하게 작업 내용을 보존하면서 개발을 계속할 수 있어!