어제 오늘 내일

[Git] 특정 브랜치만 clone 하기 (--branch, --single-branch) 본문

IT/Git

[Git] 특정 브랜치만 clone 하기 (--branch, --single-branch)

hi.anna 2025. 3. 8. 21:31

 

특정 브랜치만 클론하기

Git에서 특정 브랜치만 클론하려면 --branch 옵션과 --single-branch 옵션을 함께 사용하면 됩니다.

git clone --branch <브랜치명> --single-branch <원격저장소URL>

 

예제

 

예를 들어, feature-branch라는 브랜치만 클론하려면 다음과 같이 실행합니다.

git clone --branch feature-branch --single-branch https://github.com/user/repo.git

 

이 명령어는 다음을 수행합니다:

  • --branch: 특정 브랜치(feature-branch)를 선택
  • --single-branch: 선택한 브랜치만 클론 (다른 브랜치 정보는 받지 않음)
  • https://github.com/user/repo.git: 원격 저장소 URL

이렇게 하면 해당 브랜치의 최신 커밋만 가져오고, 나머지 브랜치들은 다운로드하지 않습니다.

 

 

--branch 옵션만 사용하면?

--single-branch 옵션 없이 --branch <브랜치명>만 사용하면,

해당 브랜치로 체크아웃되지만 다른 브랜치의 정보도 함께 가져옵니다.

git clone --branch feature-branch https://github.com/user/repo.git
  • 원격 저장소의 모든 브랜치가 로컬에 다운로드됩니다.
  • 기본적으로 지정한 feature-branch 브랜치가 체크아웃됩니다.

 

--single-branch  옵션만 사용하면?

git clone --single-branch <URL>만 입력하면, 기본 브랜치(보통 main 또는 master)만 클론됩니다.

예제:

git clone --single-branch https://github.com/user/repo.git
  • 원격 저장소의 기본 브랜치(예: main 또는 master)만 다운로드합니다.
  • 다른 브랜치는 가져오지 않습니다.
  • 특정 브랜치를 지정하지 않았기 때문에 --branch 옵션을 사용하지 않는 한 기본 브랜치가 선택됩니다.

 

 

정리

git clone <URL> 모든 브랜치 다운로드
git clone --single-branch <URL> 기본 브랜치만 다운로드
git clone --branch <브랜치명> <URL> 특정 브랜치 체크아웃, 하지만 모든 브랜치 정보 다운로드
git clone --branch <브랜치명> --single-branch <URL> 특정 브랜치만 다운로드

 

 

 

 

반응형