[Git]fatal: a branch named ' ' already exists

[Git]fatal: a branch named ' ' already exists 오류는 이미 존재하는 이름의 브랜치로 브랜치를 새로 생성할 때 나타나는 오류다. 나는 원격 브랜치 이름은 대문자이고, 실수로 소문자로 설정해버려서 대문자로 바꾸려고 했는데, 같은 문자로 인식하다 보니 생겼던 문제다. 한마디로 같은 이름이어서 충돌이 났던것.

1. 현재 로컬 브랜치 상태 확인

현재 로컬 브랜치 목록을 확인하여 충돌 원인을 파악합니다:

git branch

출력된 목록에서 21V라는 이름의 로컬 브랜치가 이미 존재하는 것을 확인할 수 있을 것입니다.

---

2. 로컬 브랜치 이름 변경

이미 존재하는 21V 로컬 브랜치의 이름을 다른 이름으로 변경합니다:

git branch -m 21V old-21V

이 명령어는 21V 로컬 브랜치를 old-21V로 이름을 변경합니다.

---

3. 원격 브랜치를 추적하는 새 로컬 브랜치 생성

origin/21V 원격 브랜치를 추적하는 새 로컬 브랜치를 생성합니다:

git checkout -t origin/21V

이 명령어는 21V라는 이름으로 새 로컬 브랜치를 생성하고, 원격 브랜치 origin/21V를 추적합니다.

---

4. 필요 없는 브랜치 삭제

old-21V 브랜치가 더 이상 필요하지 않다면 삭제할 수 있습니다:

git branch -d old-21V

참고: 브랜치가 병합되지 않은 상태라면 -d 대신 -D 플래그를 사용하세요.

---

5. 원격 브랜치 목록 확인

현재 원격 브랜치 목록을 확인하여 설정이 올바른지 확인합니다:

git branch -r

출력에서 origin/21V가 제대로 표시되는지 확인하세요.

---

문제 원인 분석

• fatal: a branch named '21V' already exists: 로컬에 21V라는 이름의 브랜치가 이미 있어서, 원격 21V 브랜치를 추적할 새 브랜치를 만들 수 없습니다.
• fatal: a branch is expected: git switch 명령어는 로컬 브랜치만 전환할 수 있으며, 원격 브랜치를 직접 사용할 수 없습니다.