Copy & Run

Git Clone 방법 정리: HTTPS, 얕은 클론, 부분 클론 비교

공개 저장소 Hello-World를 세 가지 방식으로 클론해 가져온 커밋 수, 원격 설정, 파일 내용 차이를 비교합니다. 전체 클론, --depth 1 얕은 클론, --filter=blob:none 부분 클론의 차이를 명령과 출력으로 확인합니다.

실습 노트 · 2026-11-14 발행 · 4분 · 2026-11 확인

git clone은 같은 저장소를 받아도 옵션에 따라 받는 양이 달라집니다. 이 글에서는 공개 저장소 octocat/Hello-World를 전체 클론, 얕은 클론, 부분 클론 세 가지로 받아 커밋 수와 원격 설정을 비교합니다.

준비물

항목 내용
Git 2.54.0.windows.1
실습 저장소 https://github.com/octocat/Hello-World.git (공개 저장소, 인증 없이 읽기 가능)
작업 위치 임시 디렉터리 아래 clone-lab
예상 소요 시간 약 10분

이 글에서는 HTTPS 주소로만 실행합니다. SSH 주소는 GitHub에 공개 키를 등록한 뒤에만 쓸 수 있어, 이 실습 환경에서는 실행하지 않았습니다.

1. 전체 클론

가장 기본 형태는 주소만 주는 방식입니다.

git clone https://github.com/octocat/Hello-World.git hw-full

출력은 다음과 같습니다.

Cloning into 'hw-full'...

받은 뒤 커밋 수와 원격 주소를 확인합니다.

git -C hw-full rev-list --count HEAD
git -C hw-full remote -v
3
origin	https://github.com/octocat/Hello-World.git (fetch)
origin	https://github.com/octocat/Hello-World.git (push)

전체 클론은 커밋 이력과 모든 파일 내용을 받습니다. 저장소가 클수록 시간과 디스크 사용량이 늘어납니다.

2. 얕은 클론 (--depth 1)

최신 커밋 한 개만 받으려면 --depth를 씁니다.

git clone --depth 1 https://github.com/octocat/Hello-World.git hw-shallow
git -C hw-shallow rev-list --count HEAD
cat hw-shallow/.git/shallow
1
7fd1a60b01f91b314f59955a4e4d4e80d8edf11d

.git/shallow 파일에 이력이 잘린 지점의 커밋 해시가 기록됩니다. git log는 이 커밋 한 줄만 보여 주므로, 그 이전의 변경 기록은 이 복제본에 없습니다. 빌드만 하고 이력은 볼 필요가 없을 때 씁니다.

3. 부분 클론 (--filter=blob:none)

커밋 이력은 모두 받고 파일 내용(blob)은 필요할 때 가져오는 방식입니다.

git clone --filter=blob:none https://github.com/octocat/Hello-World.git hw-blobless
git -C hw-blobless config --get remote.origin.partialclonefilter
git -C hw-blobless rev-list --count HEAD
blob:none
3

커밋 수는 전체 클론과 같습니다. 대신 파일 내용은 체크아웃이나 git show를 할 때 원격에서 받습니다. 이력 분석은 하면서 디스크는 아끼고 싶을 때 씁니다.

4. 세 방식 비교

방식 명령 커밋 수 파일 내용 이력 추적
전체 클론 git clone <주소> 3 모두 받음 가능
얕은 클론 git clone --depth 1 <주소> 1 최신 커밋만 제한됨
부분 클론 git clone --filter=blob:none <주소> 3 필요할 때 받음 가능 (내용은 지연 다운로드)

5. 확인 체크리스트

  • 전체 클론으로 커밋 3개와 원격 주소를 확인했습니다.
  • --depth 1 클론에서 커밋 1개와 .git/shallow 파일을 확인했습니다.
  • --filter=blob:none 클론에서 partialclonefilter 설정과 커밋 3개를 확인했습니다.

이 글의 다음 단계

  • npm audit --audit-level 사용법: 종료 코드로 배포 막기npm audit --audit-level은 지정한 심각도 이상의 취약점이 있을 때만 종료 코드 1을 돌려줍니다. low부터 critical까지 단계별 종료 코드와 --omit=dev를 붙였을 때의 차이를 실제 실행 결과로 확인합니다. npm script와 CI 단계에 넣는 방법도 정리합니다.
  • package.json과 package-lock.json 차이: npm ci로 확인하기package.json에는 허용하는 버전 범위가, package-lock.json에는 실제로 설치된 버전과 integrity 해시가 적힙니다. 같은 프로젝트에서 npm install과 npm ci를 번갈아 실행해 두 파일의 역할과 두 명령의 차이를 실제 출력으로 확인합니다.

이 내용을 팀 교육으로 진행하고 싶으신가요?

인원, 수준, 일정에 맞춰 실습 환경까지 준비해 진행합니다. 대상과 기간을 알려 주시면 구성을 제안해 드립니다.

교육 문의하기

교육 진행 순서와 자주 묻는 질문 보기

팀이나 교육 담당자에게 이 글 제안하기

메일로 보내실 수도 있습니다: fankh111@gmail.com

같은 카테고리의 글