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

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

- 주소: https://copyandrun.com/blog/git-clone-https-shallow-blobless-compare/
- 분야: DevSecOps
- 발행일: 2026-11-14
- 태그: git, git clone, shallow clone, partial clone, HTTPS

`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. 전체 클론

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

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

출력은 다음과 같습니다.

```text
Cloning into 'hw-full'...
```

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

```bash
git -C hw-full rev-list --count HEAD
git -C hw-full remote -v
```

```text
3
origin	https://github.com/octocat/Hello-World.git (fetch)
origin	https://github.com/octocat/Hello-World.git (push)
```

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

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

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

```bash
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
```

```text
1
7fd1a60b01f91b314f59955a4e4d4e80d8edf11d
```

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

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

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

```bash
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
```

```text
blob:none
3
```

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

## 4. 세 방식 비교

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

## 5. 확인 체크리스트

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