git branch <브랜치-이름> 또는 git checkout -b <브랜치-이름>을 사용하여 Git에서 새 브랜치를 생성할 때 fatal: A branch named '<브랜치-이름>' already exists. 오류를 만날 수 있습니다.
이는 사용하려는 이름이 로컬 저장소에서 이미 사용 중임을 나타내는 Git의 간단한 메시지입니다. 이 가이드에서는 이 상황을 처리하는 방법을 보여줍니다.
이 오류는 왜 발생하나요?
Git은 저장소의 모든 브랜치가 고유한 이름을 갖도록 요구합니다. 동일한 이름을 가진 두 개의 로컬 브랜치를 가질 수 없습니다. 이 오류는 단순히 그 규칙을 강제하는 것입니다.
이 오류가 발생하는 가장 일반적인 이유는 다음과 같습니다.
- 해당 이름으로 브랜치를 이미 만들었다는 사실을 잊어버렸습니다.
- 다른 사람들과 협업 중이며, 지금 사용하려는 이름과 동일한 이름의 브랜치를 원격 저장소에서 가져왔습니다.
- 다른 이름을 입력하려다 간단한 오타가 발생했습니다.
“Branch Already Exists” 오류 해결 방법
원하는 목표에 따라 몇 가지 옵션이 있습니다.
옵션 1: 다른 브랜치 이름 선택하기
가장 간단한 해결책은 아직 사용되지 않은 이름을 선택하는 것입니다. 이름 자체가 중요하지 않다면, 그냥 새 이름으로 다시 시도하세요.
# 실패한 명령어
git checkout -b feature/login
# 더 구체적인 이름으로 시도
git checkout -b feature/login-v2
옵션 2: 기존 브랜치로 체크아웃하기
이 오류가 표시되면 새 브랜치가 필요 없다는 것을 깨달을 수 있습니다. 단지 기존 브랜치로 전환하고 싶을 뿐입니다. 이 경우 -b 플래그 없이 git checkout을 사용하세요.
# 새 브랜치를 만드는 대신...
git checkout -b my-feature
# ...기존 브랜치로 전환하기
git checkout my-feature
모든 로컬 브랜치 목록을 보고 이름을 확인하려면 언제든지 다음을 사용할 수 있습니다.
git branch
옵션 3: 이전 브랜치 삭제하기
기존 브랜치가 오래되었거나, 구식이거나, 더 이상 필요하지 않은 경우, 해당 브랜치를 삭제한 다음 같은 이름으로 새 브랜치를 만들 수 있습니다.
경고: 브랜치를 삭제하면 해당 브랜치의 커밋이 다른 곳에 병합되지 않은 경우 데이터가 손실될 수 있습니다. 이전 브랜치의 변경 사항이 더 이상 필요 없는지 확인하세요.
- 로컬 브랜치 삭제:
-d플래그는 완전히 병합된 브랜치만 삭제합니다. 더 안전한 옵션을 위해 먼저 이것을 사용하세요.git branch -d old-feature병합되지 않았더라도 브랜치를 삭제하고 싶다면
-D플래그(강제 삭제)를 사용하세요.git branch -D old-feature - 새 브랜치 생성:
이제 이전 이름이 비었으므로 새 브랜치를 만들 수 있습니다.
git checkout -b old-feature
옵션 4: 기존 브랜치를 새 시작 지점으로 재설정하기
때로는 브랜치를 삭제하는 대신 다른 커밋에서 “다시 시작”하고 싶을 때가 있습니다. 예를 들어, feature/login을 최신 main 브랜치에서 시작하고 싶을 수 있습니다. git checkout의 --force 옵션을 사용하거나 재설정하여 이 작업을 수행할 수 있습니다.
checkout 사용 (더 간단함):
현재 HEAD에서 새 feature/login을 시작하고 이전 것은 버리려면:
git checkout -B feature/login
-B 플래그는 브랜치가 없으면 생성하고, 있으면 현재 커밋으로 재설정하라는 편리한 단축키입니다.
reset 사용 (더 명시적임):
# 재설정하려는 브랜치로 전환
git checkout feature/login
# 'main'의 최신 커밋으로 재설정
git reset --hard main
# 이제 'feature/login' 브랜치는 'main'과 동일합니다
결론
“fatal: A branch named ‘…’ already exists” 오류는 Git의 간단한 안전장치입니다. 이 오류가 표시되면 잠시 시간을 내어 git branch로 로컬 브랜치를 확인하세요. 거기서부터 다른 이름을 사용할지, 기존 브랜치로 전환할지, 또는 새 브랜치를 위해 이전 브랜치를 삭제/재설정할지 결정할 수 있습니다.
Leave a comment