본문으로 이동
Git 에러경고
You are in 'detached HEAD' state

Detached HEAD 상태

HEAD가 브랜치가 아닌 특정 커밋을 직접 가리키고 있어, 새 커밋이 고아 상태가 됩니다.

gitlinuxwindowsmacos

이 에러의 원인

로컬 브랜치 대신 특정 커밋, 태그, 또는 원격 브랜치를 직접 체크아웃했습니다. 이 상태에서 생성한 새 커밋은 어떤 브랜치에도 속하지 않아 유실될 수 있습니다.

수정 방법

작업 내용을 보존하려면 새 브랜치를 만드세요: git checkout -b new-branch. 기존 브랜치로 돌아가려면: git checkout main. 이미 커밋했다면 다른 브랜치로 전환하기 전에 브랜치를 만드세요.

예제

git checkout -b new-branch  # to save work from detached HEAD
공식 문서

관련 에러 코드