[Git] 브랜치 이름 변경하기 (로컬 & 원격 저장소)

로컬에서 브랜치 이름을 바꾸는 것은 아주 간단하지만,

이미 서버(GitHub)에 올린 브랜치의 이름을 바꾸는 과정은 조금 더 세심한 작업이 필요합니다.

 

 

1. 로컬에서 브랜치 이름 변경하기

가장 흔한 경우입니다. 오타가 났거나 더 적절한 이름으로 바꾸고 싶을 때 사용합니다.

① 현재 내가 위치한 브랜치 이름을 바꿀 때

바꾸고 싶은 브랜치로 switch한 상태라면 이름만 지정하면 됩니다.

git branch -m 새로운-브랜치-이름

② 다른 브랜치의 이름을 바꿀 때 (이동하지 않고)

현재 브랜치를 유지하면서 다른 브랜치의 이름만 슥 바꿀 때 사용합니다.

git branch -m 기존-이름 새로운-이름

 

 

2. 원격 저장소(GitHub)의 브랜치 이름 변경하기

이미 push를 완료한 브랜치라면, 로컬에서 이름을 바꾼다고 서버의 이름이 자동으로 바뀌지 않습니다.

다음 3단계 과정을 거쳐야 합니다.

1단계: 로컬에서 브랜치 이름을 바꿉니다.

git branch -m 새로운-이름

2단계: 서버에서 '기존 이름'의 브랜치를 삭제합니다.

git push origin --delete 기존-이름

3단계: '새로운 이름'의 브랜치를 서버에 푸시하고 연동합니다.

# -u 옵션을 쓰면 이후에 git push만 쳐도 이 브랜치로 연결됩니다.
git push origin -u 새로운-이름

 

 

3. 실무 꿀팁: GUI에서 클릭 한 번으로 바꾸기

명령어가 복잡하게 느껴진다면, 평소 사용하는 개발 도구를 활용하세요.

• VS Code: 하단 상태 표시줄의 브랜치 이름을 클릭한 후, 상단 입력창에서 이름을 수정할 수 있습니다.
• IntelliJ: 우측 하단의 Git: 브랜치명을 클릭하고, 해당 브랜치에서 [Rename...]을 누르면 끝입니다.
  (원격 브랜치까지 바꿀지 물어봐 주기도 해서 아주 편합니다.)

 

📝 요약

상황	명령어
현재 브랜치 이름 변경	git branch -m 새이름
원격 브랜치 이름 변경	로컬 이름 변경 → 기존 원격 삭제 → 새 이름 푸시
가장 중요한 점	동료들과 공유 중인 브랜치라면 반드시 이름을 바꿨다고 알려야 함