[GitHub] 원격 브랜치를 로컬로 가져오는 방법

---

원격 브랜치를 로컬로 가져오는 방법

1. 원격 브랜치 목록 확인

• git branch -r 명령어를 사용하여 현재 원격 저장소에 있는 브랜치 목록을 확인한다.

$ git branch -r
origin/HEAD -> origin/main
origin/feature-a
origin/main

• git remote show origin 명령어로도 확인 가능하다. 이 경우 좀 더 상세한 정보를 볼 수 있다.

2. 원격 브랜치 로컬로 가져오기 (체크아웃)

• git checkout -t <remote>/<branch> 명령어를 사용하면 원격 브랜치를 로컬로 가져오고, 바로 해당 브랜치로 전환된다.
• 예시: 원격의 feature-a 브랜치를 로컬로 가져오기

$ git checkout -t origin/feature-a
Branch 'feature-a' set up to track remote branch 'feature-a' from 'origin'.
Switched to a new branch 'feature-a'

• 이 명령어는 로컬에 feature-a라는 이름의 브랜치를 생성하고, 원격 브랜치인 origin/feature-a와 연결하는 역할을 수행한다.

3. 원격 브랜치 가져오기 (페치)

• git fetch <remote> 명령어를 사용하여 원격 저장소의 최신 변경 내용을 로컬로 가져온다.
• 예시:

$ git fetch origin
remote: Enumerating objects: 5, done.
remote: Counting objects: 100% (5/5), done.
remote: Compressing objects: 100% (3/3), done.
remote: Total 3 (delta 2), reused 0 (delta 0), pack-reused 0
Unpacking objects: 100% (3/3), 2.23 KiB | 2.23 MiB/s, done.
From https://github.com/user/repository
   8e5f20f..3f1d8c1  main       -> origin/main

• 이 명령어는 원격 브랜치의 변경 이력만 가져오고, 로컬 브랜치에 병합하지는 않는다. 로컬 작업에 영향을 주지 않으므로 안전하게 사용 가능하다.

4. 로컬 브랜치 생성 및 병합

1) git fetch를 통해 최신 이력을 가져온다.

$ git fetch origin

2) 로컬 브랜치를 생성하고, 원격 브랜치와 연결한다.

$ git checkout -b new-feature origin/new-feature

3) 원격 브랜치의 변경 내용을 현재 로컬 브랜치로 병합한다.

$ git pull origin new-feature

• git pull은 git fetch와 git merge를 한 번에 수행하는 명령어이다.

5. 결론

Git에서 원격 브랜치를 로컬로 가져오는 가장 흔하고 편리한 방법은 git checkout -t <remote>/<branch> 명령어를 사용하는 것이다. 이 방법은 로컬 브랜치를 생성하는 동시에 원격 브랜치와 연결해주기 때문이다. 하지만 변경 이력만 확인하고 싶을 때는 git fetch를 사용하는 것이 안전한 방법이다.

---