[Trouble Shooting] 깃 오류

🔹Git Switch Branch 문제

1️⃣ 증상 - 갑자기 브랜치가 사라짐

💡 상황

• CMD에서 Git 작업을 하다가 출력이 너무 많아 강제로 종료함.
• 이후 GitHub Desktop에서 브랜치 목록이 사라짐.
• git branch 명령어를 입력하니, 기존 브랜치가 아닌 (HEAD detached at <커밋번호>) 상태로 표시됨.

⬇️ 프로젝트를 cmd로 여는 방법

작업 파일 폴더 경로 창에 cmd 작성

 

 

2️⃣ 문제 원인

Git이 강제 종료되면서 현재 브랜치에서 분리된(Detached) 상태로 변경됨.
즉, 원래 작업하던 브랜치가 아닌 특정 커밋에 고정된 상태로 남아있음.

 

📌 Detached HEAD란?

"Detached HEAD" 상태란 브랜치 없이 특정 커밋만 참조하는 상태
이 상태에서는 새로운 커밋을 해도 브랜치에 반영되지 않습니다.

 

 

3️⃣ 해결

1. 현재 상태 확인

우선, 현재 Git 상태를 확인해야 합니다.
CMD 창을 열고 프로젝트 폴더로 이동한 뒤, 다음 명령어를 실행하세요.

git branch

* (HEAD detached at 5f6d9ad) main develop

위처럼 (HEAD detached at <커밋번호>) 가 보이면 가상 브랜치 상태입니다.

 

2. 잠금 파일(index.lock) 삭제

Git이 비정상 종료되면 .git/index.lock 파일이 남아 있을 수 있습니다.
이 파일이 있으면 브랜치를 전환할 수 없으므로 삭제해야 합니다.

del .git\index.lock

 

➕ 추가 행동:
GitHub Desktop도 함께 종료해주었습니다.
작업 관리자 → git.exe, GitHubDesktop.exe 종료 후 다시 시도

 

3. 브랜치로 복귀

이제 기존 브랜치로 되돌아갑니다.

 

git switch 브랜치명