Git - 원격 브랜치가 있는데 로컬에는 없을 때, 브랜치 생성 및 연결 방법

 

시작하면서

Git을 사용하다 보면 이런 상황이 자주 생긴다."원격에는 develop 브랜치가 있는데, 로컬에는 없다. 그래서 로컬 브랜치를 만들고 원격 브랜치랑 연결하고 싶다." 이번 글에서는 이럴 때 사용할 수 있는 명령어를 정리해두자.

• 원격 저장소에는 origin/develop 브랜치가 이미 존재함.
• 하지만 로컬에는 develop 브랜치가 없음.
• 로컬에서 develop 브랜치를 생성하고, 원격 브랜치와 연결(tracking) 해야 함.

---

방법 1. checkout으로 로컬 브랜치 만들면서 연결하기

git checkout -b develop origin/develop

설명:

• -b develop: 로컬에 develop 브랜치를 새로 만든다.
• origin/develop: 원격 브랜치를 기준으로 브랜치를 만든다.
• 이 명령어는 자동으로 tracking branch로 설정된다.

즉, 앞으로 git pull이나 git push를 할 때 따로 origin develop을 지정하지 않아도 된다.

---

방법 2. switch --track (Git 2.23 이상)

git switch --track origin/develop

설명:

• --track: 원격 브랜치를 추적(tracking)하는 로컬 브랜치를 만든다.
• origin/develop을 자동으로 기준으로 삼는다.

Git 버전이 2.23 이상이라면, switch 명령어가 좀 더 직관적이고 추천된다.

---

브랜치 연결 상태 확인하기

git branch -vv

• 현재 로컬 브랜치들이 어떤 원격 브랜치를 추적 중인지 확인할 수 있다.

---

정리

상황	명령어
원격 브랜치가 있고 로컬에 브랜치가 없음	git checkout -b develop origin/develop
최신 Git 사용 중이라면	git switch --track origin/develop
연결 상태 확인	git branch -vv