LainyZine: 프로그래머 가이드 🐣

GitHub 저장소의 브랜치 이름을 변경하는 방법

GitHub를 사용해서 저장소를 관리하면 로컬과 원격(GitHub) 양 쪽의 소스 코드와 브랜치를 모두 관리해야합니다. 이 글에서는 로컬 브랜치의 이름을 변경하고 GitHub에도 반영하는 방법을 소개합니다.

로컬 Git 저장소 브랜치의 이름을 변경하기

git branchm 옵션을 사용하면 브랜치 이름을 변경할 수 있습니다. [OLD_BRANCH]에는 이름을 변경하고 싶은 브랜치를 지정하고, [NEW_BRANCH]에는 새로운 브랜치 이름을 지정합니다.

$ git branch -m [OLD_BRANCH] [NEW_BRANCH]

간단한 예제를 통해 동작을 확인해보겠습니다. 먼저 old_branch라는 브랜치를 하나 만들고 브랜치 목록을 확인해봅니다.

$ git branch old_branch

$ git branch
* master
  old_branch

이제 m 옵션을 사용해 old_branchnew_branch로 변경하고, 브랜치 목록을 확인해봅니다.

$ git branch -m old_branch new_branch

$ git branch
* master
  new_branch

이름이 변경되어 old_branch는 사라지고 new_branch만 남아있는 것이 보입니다. 브랜치 명령어는 브랜치만 생성하기 때문에 실제로 작업하려면 checkout을 해야합니다.

브랜치 이름 변경이 아니라, 단순 삭제에 대해서는 다음 글에서 자세히 소개합니다.

GitHub 저장소 브랜치 이름을 바꾸기

GitHub 저장소에도 masterold_branch가 존재하는 상황을 생각해보겠습니다. 이제 로컬에서 old_branchnew_branch로 변경한 내용을 GitHub 저장소에도 반영하고 싶습니다.

원리는 간단합니다. 원격(여기서는 origin)의 old_branch를 삭제하고, 로컬의 new_branch를 원격에 push하는 해줍니다. 따로 안전장치는 없기 때문에 작업 전에는 코드 상태를 꼭 확인해주세요.

먼저 origin에 새로운 브랜치를 생성해줍니다.

$ git push origin new_branch

로컬 브랜치 new_branch가 origin에 push되었습니다. 이제 origin의 old_branch를 삭제하면 됩니다. 아래 두 명령어 모두 origin의 olb_branch를 삭제해줍니다. 자주 사용하는 명령어이니 둘 다 알아두면 도움이 됩니다. (하나만 실행하면 됩니다)

$ git push origin --delete old_branch
$ git push origin :old_branch

브랜치 생성과 삭제를 한 번에 할 수도 있습니다. 아래 명령어는 rename 기능은 아닙니다만, old_branch를 삭제하고 new_branch push를 한 번에 해줍니다.

$ git push origin :old_branch new_branch

로컬/GitHub 저장소의 브랜치 이름 변경 방법 정리

로컬 브랜치의 이름 변경은 git branchm 옵션을 사용합니다.

$ git branch -m [OLD_BRANCH] [NEW_BRANCH]

GitHub나 원격 저장소의 변경은 git push를 활용합니다.

$ git push origin new_branch
$ git push origin --delete old_branch

old_branch를 삭제하고 new_branch 푸시를 한 방에 할 수도 있습니다.

$ git push origin :old_branch new_branch
LainyZine은 쿠팡 파트너스 활동에 따른 수수료를 제공받습니다.