# 구조

# Git 내부 구조 (Basic)

---

## <span style="white-space: pre-wrap;">1. Git은 파일 버전이 아닌 </span>****스냅샷 시스템****

<span style="white-space: pre-wrap;">Git은 "변경점(diff)"이 아니라, </span>****전체 프로젝트의 스냅샷(상태)을 저장****한다.

> 커밋 하나 = 전체 폴더의 압축 스냅샷 (단, 중복은 자동 제거됨)

---

## 2. Git의 3대 영역

```text
작업 디렉토리      →    스테이징 영역       →    로컬 저장소
(Working Directory)     (Staging/Index)         (Repository/.git)
   코드 작성                 git add                 git commit
```

<table id="bkmrk-%EC%98%81%EC%97%AD%EC%84%A4%EB%AA%85%EC%9E%91%EC%97%85-%EB%94%94%EB%A0%89%ED%86%A0%EB%A6%AC%EC%8B%A4%EC%A0%9C%EB%A1%9C-%EC%BD%94%EB%93%9C-%EC%9E%91%EC%84%B1"><colgroup><col></col><col></col></colgroup><tbody><tr><th>영역

</th><th>설명

</th></tr><tr><td>작업 디렉토리

</td><td>실제로 코드 작성/수정하는 공간

</td></tr><tr><td>스테이징 영역 (Index)

</td><td>커밋할 파일을 담아두는 임시 공간 (`<span class="editor-theme-code">git add</span>`)

</td></tr><tr><td>로컬 저장소

</td><td><span style="white-space: pre-wrap;">커밋이 저장되는 </span>`<span class="editor-theme-code">.git</span>`<span style="white-space: pre-wrap;"> 디렉토리</span>

</td></tr></tbody></table>

---

## 3. 주요 Git 내부 객체

Git은 4가지 핵심 객체로 이루어져 있습니다:

<table id="bkmrk-%EA%B0%9D%EC%B2%B4%EC%84%A4%EB%AA%85%EC%98%88%EC%8B%9C%F0%9F%94%B9-blob%ED%8C%8C%EC%9D%BC-%EB%82%B4%EC%9A%A9-%EC%A0%80%EC%9E%A5"><colgroup><col></col><col></col><col></col></colgroup><tbody><tr><th>객체

</th><th>설명

</th><th>예시

</th></tr><tr><td>🔹 Blob

</td><td>파일 내용 저장 (binary large object)

</td><td>`<span class="editor-theme-code">hello.java</span>`<span style="white-space: pre-wrap;"> 내용</span>

</td></tr><tr><td>🔸 Tree

</td><td>디렉토리 구조와 파일 리스트

</td><td>폴더 구조

</td></tr><tr><td>🔹 Commit

</td><td>커밋 메타데이터 + 부모 커밋 + tree

</td><td>"커밋 메시지"

</td></tr><tr><td>🔸 Tag

</td><td>특정 커밋에 이름 부여

</td><td>v1.0.0

</td></tr></tbody></table>

📦 커밋은 tree를 가리키고, tree는 blob들을 가리킵니다.

```
[commit]
   |
   v
[tree]
 ├── [blob] hello.txt
 └── [blob] app.js
```

---

## 4. HEAD란?

```bash
HEAD → 현재 체크아웃한 브랜치 or 커밋
```

- <span style="white-space: pre-wrap;">보통은 </span>`<span class="editor-theme-code">HEAD → main</span>`
- `<span class="editor-theme-code">git checkout</span>`<span style="white-space: pre-wrap;"> 하면 HEAD가 다른 커밋을 가리킴</span>
- `<span class="editor-theme-code">git reset</span>`<span style="white-space: pre-wrap;">은 </span>****HEAD의 위치를 옮기는 것****

---

## 5. 브랜치란?

<span style="white-space: pre-wrap;">브랜치는 단지 </span>****커밋을 가리키는 포인터****이다.

```
A---B---C  ← main (브랜치)
        ↑
      HEAD
```

- 브랜치를 옮긴다 → 포인터 이동
- 커밋한다 → 현재 브랜치가 가리키는 곳에서 새로운 커밋 추가

---

## 6. Reflog란?

```bash
git reflog
```

<span style="white-space: pre-wrap;">→ HEAD와 브랜치가 가리키던 </span>****이전 위치들의 로그****

- `<span class="editor-theme-code">reset</span>`<span style="white-space: pre-wrap;">이나 </span>`<span class="editor-theme-code">checkout</span>`<span style="white-space: pre-wrap;"> 후에도 추적 가능</span>
- 내부적으로 Git은 HEAD의 이동을 계속 추적함

---

## 7. .git 디렉토리 구조 요약

```
.git/
├── objects/       ← 커밋, 트리, 블롭, 태그 객체 저장소
├── refs/          ← 브랜치, 태그 등의 포인터
├── HEAD           ← 현재 가리키는 브랜치
├── index          ← 스테이징 정보
├── logs/          ← reflog 정보 저장
└── config         ← Git 설정
```

---

## 📌 정리

<table id="bkmrk-%EA%B0%9C%EB%85%90%EC%84%A4%EB%AA%85commit%EC%A0%84%EC%B2%B4-%EC%8A%A4%EB%83%85%EC%83%B7-%2B-%EB%B6%80"><colgroup><col></col><col></col></colgroup><tbody><tr><th>개념

</th><th>설명

</th></tr><tr><td>Commit

</td><td>전체 스냅샷 + 부모 커밋 정보

</td></tr><tr><td>Blob

</td><td>파일 내용 저장

</td></tr><tr><td>Tree

</td><td>폴더 구조

</td></tr><tr><td>Branch

</td><td>커밋을 가리키는 포인터

</td></tr><tr><td>HEAD

</td><td>현재 브랜치 or 커밋

</td></tr><tr><td>Staging Area

</td><td>다음 커밋을 준비하는 공간

</td></tr><tr><td>Reflog

</td><td>HEAD의 이동 이력 추적 가능 (복구에 유용)

</td></tr></tbody></table>

---

# Git 내부 구조 (Advanced)

---

## 1. 🔐 Git 객체의 SHA-1 해시 구조

### 1.1 개요

<span style="white-space: pre-wrap;">Git은 모든 객체(blob, tree, commit 등)를 </span>****SHA-1 해시 값****을 통해 식별한다.

> 하나의 커밋은 고유한 40자리 16진수 해시로 구분됨

### 1.2 예시

```bash
e83c5163... ← 커밋, 블롭, 트리 모두 이 해시값으로 관리됨
```

### 1.3 내부 생성 방식

1. <span style="white-space: pre-wrap;">Git은 객체의 </span>****타입 + 크기 + 내용****을 문자열로 만듦  
    <span style="white-space: pre-wrap;">예: </span>`<span class="editor-theme-code">blob 12\0Hello World\n</span>`
2. 이를 SHA-1으로 해싱하여 파일 이름으로 저장

```bash
echo "Hello World" | git hash-object --stdin
→ 557db03de997c86a4a028e1ebd3a1ceb225be238
```

---

## 2. Git의 packfile 압축 구조

### 2.1 개요

<span style="white-space: pre-wrap;">Git은 수천 개의 객체를 </span>`<span class="editor-theme-code">.git/objects</span>`<span style="white-space: pre-wrap;"> 디렉토리에 저장하지만, 리포지토리가 커지면 성능 저하가 발생합니다. 이를 해결하기 위해 \*\*packfile(.pack)\*\*을 사용합니다.</span>

### 2.2 packfile이란?

> <span style="white-space: pre-wrap;">여러 Git 객체를 </span>****압축하고 델타(차이)****<span style="white-space: pre-wrap;"> 형태로 저장한 파일</span>

### 2.3 저장 구조

```text
.git/
└── objects/
    ├── pack/
    │   ├── pack-xxxxx.pack   ← 실제 압축된 객체
    │   └── pack-xxxxx.idx    ← 인덱스 파일
```

### 2.4 생성 명령어

```bash
git gc      # 자동으로 packfile 생성 (garbage collection)
```

### 2.5 특징

<table id="bkmrk-%ED%8A%B9%EC%A7%95%EC%84%A4%EB%AA%85%EA%B3%B5%EA%B0%84-%EC%A0%88%EC%95%BD%EB%B9%84%EC%8A%B7%ED%95%9C-%ED%8C%8C%EC%9D%BC%EC%9D%80-%EB%8D%B8%ED%83%80-"><colgroup><col></col><col></col></colgroup><tbody><tr><th>특징

</th><th>설명

</th></tr><tr><td>공간 절약

</td><td>비슷한 파일은 델타 방식으로 저장됨

</td></tr><tr><td>빠른 복사

</td><td>clone, fetch, push 성능 향상

</td></tr><tr><td>불변성 보장

</td><td>packfile 내 객체는 변경 불가, 안전함

</td></tr></tbody></table>

---

## 3. Git vs SVN 비교

<table id="bkmrk-%ED%95%AD%EB%AA%A9gitsvn%EC%A0%80%EC%9E%A5-%EB%B0%A9%EC%8B%9D%EB%B6%84%EC%82%B0-%EB%B2%84%EC%A0%84-%EA%B4%80"><colgroup><col></col><col></col><col></col></colgroup><tbody><tr><th>항목

</th><th>Git

</th><th>SVN

</th></tr><tr><td>저장 방식

</td><td>분산 버전 관리 (DVCS)

</td><td>중앙 집중식 (CVCS)

</td></tr><tr><td>커밋 저장소

</td><td>로컬과 원격 모두

</td><td>중앙 서버

</td></tr><tr><td>브랜치

</td><td>가볍고 빠름 (포인터)

</td><td>디렉토리 복사 방식

</td></tr><tr><td>네트워크 필요 여부

</td><td>X (로컬 커밋 가능)

</td><td>O (항상 서버 접속 필요)

</td></tr><tr><td>속도

</td><td>빠름 (로컬 기반)

</td><td>느림 (서버 기반)

</td></tr><tr><td>merge &amp; rebase

</td><td>고급 기능 다양

</td><td>제한적 기능

</td></tr><tr><td>사용 예

</td><td>GitHub, GitLab, OSS 등

</td><td>일부 기업 내부 시스템

</td></tr></tbody></table>

### 3.1 핵심 차이

<span style="white-space: pre-wrap;">| Git은 </span>****로컬에서도 모든 기능 사용 가능****, 브랜치가 lightweight  
→ 오프라인, 분기 많은 프로젝트에 최적화

<span style="white-space: pre-wrap;">| SVN은 중앙 서버 기반으로 </span>****단순하고 통제된 작업****에 적합  
→ 사내 규칙이 명확한 환경에 적합

---

## 요약

<table id="bkmrk-%EC%A3%BC%EC%A0%9C%EC%9A%94%EC%A0%90sha-1-%ED%95%B4%EC%8B%9Cgit-%EA%B0%9D%EC%B2%B4%EB%8A%94-"><colgroup><col></col><col></col></colgroup><tbody><tr><th>주제

</th><th>요점

</th></tr><tr><td>SHA-1 해시

</td><td>Git 객체는 타입+내용 기반으로 해시 생성

</td></tr><tr><td>packfile

</td><td>성능 최적화를 위한 객체 압축 저장소

</td></tr><tr><td>Git vs SVN

</td><td>Git은 분산 &amp; 유연, SVN은 중앙 &amp; 단순

</td></tr></tbody></table>

---

# commit 생성시 .git 내부 변화

---

## 시나리오

1. `<span class="editor-theme-code">hello.txt</span>`<span style="white-space: pre-wrap;"> 파일 생성</span>
2. `<span class="editor-theme-code">git add hello.txt</span>`
3. `<span class="editor-theme-code">git commit -m "Add hello"</span>`

---

## 1. 작업 디렉토리 (Working Directory)

```bash
echo "Hello Git" > hello.txt
```

- 파일 생성됨
- 아직 Git은 이 파일을 추적하지 않음

---

## <span style="white-space: pre-wrap;">2. </span>`<span class="editor-theme-code">git add hello.txt</span>`

```bash
git add hello.txt
```

### 내부 변화:

<table id="bkmrk-%EA%B5%AC%EC%84%B1%EC%9A%94%EC%86%8C%EB%B3%80%ED%99%94-%EB%82%B4%EC%9A%A9.git%2Findex%EC%8A%A4"><colgroup><col></col><col></col></colgroup><tbody><tr><th>구성요소

</th><th>변화 내용

</th></tr><tr><td>`<span class="editor-theme-code">.git/index</span>`

</td><td>스테이징 영역에 파일 등록됨 (경로, 해시, 권한 등 저장)

</td></tr><tr><td>`<span class="editor-theme-code">.git/objects/</span>`

</td><td>`<span class="editor-theme-code">hello.txt</span>`

<span style="white-space: pre-wrap;">의 내용이 </span>

`<span class="editor-theme-code">blob</span>`

<span style="white-space: pre-wrap;"> 객체로 저장됨 (SHA-1 해시 기반)</span>

</td></tr></tbody></table>

📦 예시 구조:

```
.git/
└── objects/
    └── 3a/
        └── 3efbed4aef... ← hello.txt의 blob 객체
```

---

## <span style="white-space: pre-wrap;">3. </span>`<span class="editor-theme-code">git commit -m "Add hello"</span>`

### 내부 변화:

#### .git/objects/

<table id="bkmrk-%EA%B0%9D%EC%B2%B4%EB%82%B4%EC%9A%A9tree-%EA%B0%9D%EC%B2%B4%EC%BB%A4%EB%B0%8B-%EB%8B%B9%EC%8B%9C%EC%9D%98-%EB%94%94%EB%A0%89"><colgroup><col></col><col></col></colgroup><tbody><tr><th>객체

</th><th>내용

</th></tr><tr><td>`<span class="editor-theme-code">tree</span>`

<span style="white-space: pre-wrap;"> 객체</span>

</td><td>커밋 당시의 디렉토리 구조 (hello.txt 포함)

</td></tr><tr><td>`<span class="editor-theme-code">commit</span>`

<span style="white-space: pre-wrap;"> 객체</span>

</td><td>커밋 메시지, 트리 포인터, 작성자 등 메타데이터 포함

</td></tr></tbody></table>

```text
.git/objects/
├── 3a/...(blob)
├── 47/... (tree)
└── a1/... (commit)
```

#### .git/refs/heads/main

- 브랜치 포인터가 새 커밋 해시로 갱신됨

```text
refs/heads/main → a1b2c3d4e5...
```

#### .git/HEAD

- <span style="white-space: pre-wrap;">여전히 </span>`<span class="editor-theme-code">ref: refs/heads/main</span>`<span style="white-space: pre-wrap;"> 상태 → main 브랜치를 따라감</span>

#### .git/logs/HEAD &amp; logs/refs/heads/main

- <span style="white-space: pre-wrap;">커밋 전후 </span>`<span class="editor-theme-code">HEAD</span>`<span style="white-space: pre-wrap;"> 포인터 변경 이력 추가됨 (reflog)</span>

```
0000000 → a1b2c3d4 Commit: Add hello
```

---

## 전체 흐름 (커밋 1회 시)

```text
📁 Working Directory       ← hello.txt 생성
    ↓ git add
📂 .git/index              ← 스테이징 정보 저장
    ↓ git commit
📦 .git/objects/
    ├── blob (파일 내용)
    ├── tree (디렉토리 구조)
    └── commit (메타데이터)

📄 .git/refs/heads/main    ← 브랜치 → 커밋 연결
    ↑
📌 .git/HEAD               ← 현재 브랜치 추적
🕓 .git/logs/              ← HEAD/브랜치 이력 추적
```

---

## 실제 파일 (커밋 후)

```bash
cat .git/HEAD
# ref: refs/heads/main

cat .git/refs/heads/main
# a1b2c3d4e5...

git ls-tree HEAD
# 100644 blob 3a3efbed...	hello.txt

git cat-file -p <커밋해시>
# tree 47fa...
# author ...
# message: Add hello
```

---

## 요약

<table id="bkmrk-%EB%8B%A8%EA%B3%84%EC%84%A4%EB%AA%85git-addblob-%EA%B0%9D%EC%B2%B4-%EC%83%9D"><colgroup><col></col><col></col></colgroup><tbody><tr><th>단계

</th><th>설명

</th></tr><tr><td>`<span class="editor-theme-code">git add</span>`

</td><td>blob 객체 생성 + index 등록

</td></tr><tr><td>`<span class="editor-theme-code">git commit</span>`

</td><td>tree + commit 객체 생성, 브랜치 포인터 이동

</td></tr><tr><td>`<span class="editor-theme-code">.git</span>`<span style="white-space: pre-wrap;"> 내부</span>

</td><td>objects, refs, HEAD, logs 전부 갱신

</td></tr></tbody></table>

---

# Git 명령어에 따른 .git 내부 구조 변화(1부)

---

## <span style="white-space: pre-wrap;">1. </span>`<span class="editor-theme-code">git merge</span>`<span style="white-space: pre-wrap;"> 시 내부 변화</span>

### 1.1 예시 명령어

```bash
git checkout main
git merge feature
```

### <span style="white-space: pre-wrap;">1.2 </span>`<span class="editor-theme-code">.git</span>`<span style="white-space: pre-wrap;"> 내부 변화</span>

<table id="bkmrk-%EA%B5%AC%EC%84%B1-%EC%9A%94%EC%86%8C%EB%B3%80%ED%99%94-%EB%82%B4%EC%9A%A9.git%2Fobjec"><colgroup><col></col><col></col></colgroup><tbody><tr><th>구성 요소

</th><th>변화 내용

</th></tr><tr><td>`<span class="editor-theme-code">.git/objects/</span>`

</td><td><span style="white-space: pre-wrap;">병합 결과로 새로운 </span>****merge commit****<span style="white-space: pre-wrap;"> 객체 생성</span>

</td></tr><tr><td>`<span class="editor-theme-code">.git/refs/heads/main</span>`

</td><td>브랜치 포인터가 merge 커밋으로 이동

</td></tr><tr><td>`<span class="editor-theme-code">.git/HEAD</span>`

</td><td><span style="white-space: pre-wrap;">여전히 </span>`<span class="editor-theme-code">ref: refs/heads/main</span>`<span style="white-space: pre-wrap;"> 유지</span>

</td></tr><tr><td>`<span class="editor-theme-code">.git/MERGE_HEAD</span>`

</td><td>병합 대상 커밋(`<span class="editor-theme-code">feature</span>`) 해시 저장 (병합 중일 때 생성됨)

</td></tr><tr><td>`<span class="editor-theme-code">.git/logs/HEAD</span>`

</td><td>HEAD의 이동 이력 반영됨 (reflog)

</td></tr></tbody></table>

### 1.3 도식 예시

```
A---B---C ← main
     \    
      D---E ← feature

▶ git merge feature

결과:

A---B---C-------M (merge commit) ← main, HEAD
     \         /
      D---E
```

---

## <span style="white-space: pre-wrap;">2. </span>`<span class="editor-theme-code">git rebase</span>`<span style="white-space: pre-wrap;"> 시 내부 변화</span>

### 2.1 예시 명령어

```bash
git checkout feature
git rebase main
```

### <span style="white-space: pre-wrap;">2.2 </span>`<span class="editor-theme-code">.git</span>`<span style="white-space: pre-wrap;"> 내부 변화</span>

<table id="bkmrk-%EA%B5%AC%EC%84%B1-%EC%9A%94%EC%86%8C%EB%B3%80%ED%99%94-%EB%82%B4%EC%9A%A9.git%2Fobjec-1"><colgroup><col></col><col></col></colgroup><tbody><tr><th>구성 요소

</th><th>변화 내용

</th></tr><tr><td>`<span class="editor-theme-code">.git/objects/</span>`

</td><td>`<span class="editor-theme-code">feature</span>`<span style="white-space: pre-wrap;">의 커밋들을 기반 변경 후 새 커밋으로 </span>****재작성****

</td></tr><tr><td>`<span class="editor-theme-code">.git/refs/heads/feature</span>`

</td><td>브랜치가 새 커밋들로 덮어씀

</td></tr><tr><td>`<span class="editor-theme-code">.git/REBASE_HEAD</span>`

</td><td>리베이스 기준 커밋을 기록

</td></tr><tr><td>`<span class="editor-theme-code">.git/HEAD</span>`

</td><td><span style="white-space: pre-wrap;">여전히 </span>`<span class="editor-theme-code">ref: refs/heads/feature</span>`

</td></tr><tr><td>`<span class="editor-theme-code">.git/logs/HEAD</span>`

</td><td>HEAD의 커밋 재작성 이력 반영됨

</td></tr></tbody></table>

### 2.3 도식 예시

```
main:    A---B---C
feature:           D---E

▶ git rebase main

결과:
main:    A---B---C
feature:           D'---E' ← HEAD
```

> <span style="white-space: pre-wrap;">원래 커밋 D, E는 삭제되지 않고 </span>`<span class="editor-theme-code">.git/objects</span>`에 보존됨

---

## <span style="white-space: pre-wrap;">3. </span>`<span class="editor-theme-code">git reset</span>`<span style="white-space: pre-wrap;"> 시 내부 변화</span>

### 3.1 예시 명령어

```bash
git reset --hard HEAD~1
```

### <span style="white-space: pre-wrap;">3.2 </span>`<span class="editor-theme-code">.git</span>`<span style="white-space: pre-wrap;"> 내부 변화</span>

<table id="bkmrk-%EA%B5%AC%EC%84%B1-%EC%9A%94%EC%86%8C%EB%B3%80%ED%99%94-%EB%82%B4%EC%9A%A9.git%2Frefs%2F"><colgroup><col></col><col></col></colgroup><tbody><tr><th>구성 요소

</th><th>변화 내용

</th></tr><tr><td>`<span class="editor-theme-code">.git/refs/heads/main</span>`

</td><td>브랜치 포인터가 이전 커밋으로 이동

</td></tr><tr><td>`<span class="editor-theme-code">.git/HEAD</span>`

</td><td><span style="white-space: pre-wrap;">여전히 </span>`<span class="editor-theme-code">ref: refs/heads/main</span>`

</td></tr><tr style="height: 10px;"><td>`<span class="editor-theme-code">.git/index</span>`

</td><td>되돌린 커밋 시점으로 스테이징 영역 초기화

</td></tr><tr><td>작업 디렉토리

</td><td>`<span class="editor-theme-code">--hard</span>`인 경우 파일도 초기화

</td></tr><tr><td>`<span class="editor-theme-code">.git/ORIG_HEAD</span>`

</td><td>이전 HEAD 커밋 해시를 저장

</td></tr><tr><td>`<span class="editor-theme-code">.git/logs/HEAD</span>`

</td><td>이동 전후 이력 기록됨

</td></tr></tbody></table>

### 3.3 도식 예시

```
A---B---C ← main, HEAD
        ↑
     ORIG_HEAD

▶ git reset --hard B

결과:

A---B ← main, HEAD
```

---

## 4. 특수 HEAD 파일 요약

<table id="bkmrk-%ED%8C%8C%EC%9D%BC-%EC%9D%B4%EB%A6%84%EC%83%9D%EC%84%B1-%EC%8B%9C%EC%A0%90%EC%84%A4%EB%AA%85.git%2Fmer"><colgroup><col></col><col></col><col></col></colgroup><tbody><tr><th>파일 이름

</th><th>생성 시점

</th><th>설명

</th></tr><tr><td>`<span class="editor-theme-code">.git/MERGE_HEAD</span>`

</td><td>`<span class="editor-theme-code">git merge</span>`<span style="white-space: pre-wrap;"> 수행 중</span>

</td><td>병합 대상 커밋 해시 저장

</td></tr><tr><td>`<span class="editor-theme-code">.git/REBASE_HEAD</span>`

</td><td>`<span class="editor-theme-code">git rebase</span>`<span style="white-space: pre-wrap;"> 수행 중</span>

</td><td>기준 커밋 해시 저장

</td></tr><tr><td>`<span class="editor-theme-code">.git/ORIG_HEAD</span>`

</td><td>`<span class="editor-theme-code">git reset</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">merge</span>`<span style="white-space: pre-wrap;"> 등</span>

</td><td>리셋 전 커밋 백업

</td></tr><tr><td>`<span class="editor-theme-code">.git/FETCH_HEAD</span>`

</td><td>`<span class="editor-theme-code">git fetch</span>`<span style="white-space: pre-wrap;"> 이후</span>

</td><td>원격에서 받아온 커밋들 정보

</td></tr><tr><td>`<span class="editor-theme-code">.git/CHERRY_PICK_HEAD</span>`

</td><td>`<span class="editor-theme-code">git cherry-pick</span>`<span style="white-space: pre-wrap;"> 중 충돌 시</span>

</td><td>적용 대상 커밋 기록

</td></tr></tbody></table>

---

## 5. 요약 비교표

<table id="bkmrk-%EB%AA%85%EB%A0%B9%EC%96%B4%EC%BB%A4%EB%B0%8B-%EC%9D%B4%EB%8F%99%EB%B8%8C%EB%9E%9C%EC%B9%98-%EC%9D%B4%EB%8F%99head-%EB%B3%80"><colgroup><col></col><col></col><col></col><col></col><col></col><col></col></colgroup><tbody><tr><th>명령어

</th><th>커밋 이동

</th><th>브랜치 이동

</th><th>HEAD 변경

</th><th>디렉토리 영향

</th><th>특수 파일 생성

</th></tr><tr><td>`<span class="editor-theme-code">merge</span>`

</td><td>⭕

</td><td>⭕

</td><td>⭕

</td><td>충돌 시 변동 있음

</td><td>`<span class="editor-theme-code">MERGE_HEAD</span>`

</td></tr><tr><td>`<span class="editor-theme-code">rebase</span>`

</td><td>⭕ (rewrite)

</td><td>⭕

</td><td>⭕

</td><td>충돌 시 변동 있음

</td><td>`<span class="editor-theme-code">REBASE_HEAD</span>`

</td></tr><tr><td>`<span class="editor-theme-code">reset --hard</span>`

</td><td>⭕ (이전 커밋으로)

</td><td>⭕

</td><td>⭕

</td><td>✔️ 완전 초기화

</td><td>`<span class="editor-theme-code">ORIG_HEAD</span>`

</td></tr></tbody></table>

---

#####   

# Git 명령어에 따른 .git 내부 구조 변화 (2부)

---

## <span style="white-space: pre-wrap;">4. </span>`<span class="editor-theme-code">git stash</span>`<span style="white-space: pre-wrap;"> 시 내부 변화</span>

### 4.1 예시 명령어

```bash
git stash
```

### <span style="white-space: pre-wrap;">4.2 </span>`<span class="editor-theme-code">.git</span>`<span style="white-space: pre-wrap;"> 내부 변화</span>

<table id="bkmrk-%EA%B5%AC%EC%84%B1-%EC%9A%94%EC%86%8C%EB%B3%80%ED%99%94-%EB%82%B4%EC%9A%A9.git%2Fobjec"><colgroup><col></col><col></col></colgroup><tbody><tr><th>구성 요소

</th><th>변화 내용

</th></tr><tr><td>`<span class="editor-theme-code">.git/objects/</span>`

</td><td><span style="white-space: pre-wrap;">현재 작업 상태(스냅샷)가 </span>`<span class="editor-theme-code">stash</span>`용 커밋으로 저장됨 (2~3개의 커밋 객체)

</td></tr><tr><td>`<span class="editor-theme-code">.git/logs/refs/stash</span>`

</td><td>새로운 stash가 추가된 로그 생성

</td></tr><tr><td>`<span class="editor-theme-code">.git/refs/stash</span>`

</td><td>가장 최신 stash를 가리키는 포인터 (없으면 새로 생성됨)

</td></tr></tbody></table>

```bash
.git/
├── objects/        ← stash 내용 포함 커밋 객체 추가
├── refs/stash      ← 최신 stash 참조
├── logs/refs/stash ← stash 이력 저장
```

### 4.3 도식 예시

```
main:    A---B---C
               ↑
           HEAD / index

▶ git stash

결과:
- 워킹 디렉토리와 인덱스 초기화됨
- .git/refs/stash → stash 커밋 가리킴
```

---

## <span style="white-space: pre-wrap;">5. </span>`<span class="editor-theme-code">git cherry-pick</span>`<span style="white-space: pre-wrap;"> 시 내부 변화</span>

### 5.1 예시 명령어

```bash
git cherry-pick a1b2c3d
```

### <span style="white-space: pre-wrap;">5.2 </span>`<span class="editor-theme-code">.git</span>`<span style="white-space: pre-wrap;"> 내부 변화</span>

<table id="bkmrk-%EA%B5%AC%EC%84%B1-%EC%9A%94%EC%86%8C%EB%B3%80%ED%99%94-%EB%82%B4%EC%9A%A9.git%2Fobjec-1"><colgroup><col></col><col></col></colgroup><tbody><tr><th>구성 요소

</th><th>변화 내용

</th></tr><tr><td>`<span class="editor-theme-code">.git/objects/</span>`

</td><td><span style="white-space: pre-wrap;">cherry-pick된 커밋 내용 기반으로 </span>****새 커밋 객체****<span style="white-space: pre-wrap;"> 생성</span>

</td></tr><tr><td>`<span class="editor-theme-code">.git/CHERRY_PICK_HEAD</span>`

</td><td>대상 커밋의 해시 저장 (충돌 발생 시 사용됨)

</td></tr><tr><td>`<span class="editor-theme-code">.git/HEAD</span>`

</td><td>현재 브랜치에 새 커밋 추가

</td></tr><tr><td>`<span class="editor-theme-code">.git/index</span>`

</td><td>병합 결과 반영

</td></tr></tbody></table>

### 5.3 도식 예시

```
main:    A---B---C ← HEAD
feature:         D---E ← cherry-pick 대상

▶ git cherry-pick E

결과:
main:    A---B---C---E' ← HEAD
```

> E와 동일한 내용이지만 새 커밋 E′가 만들어짐

---

## <span style="white-space: pre-wrap;">6. </span>`<span class="editor-theme-code">git revert</span>`<span style="white-space: pre-wrap;"> 시 내부 변화</span>

### 6.1 예시 명령어

```bash
git revert C
```

### <span style="white-space: pre-wrap;">6.2 </span>`<span class="editor-theme-code">.git</span>`<span style="white-space: pre-wrap;"> 내부 변화</span>

<table id="bkmrk-%EA%B5%AC%EC%84%B1-%EC%9A%94%EC%86%8C%EB%B3%80%ED%99%94-%EB%82%B4%EC%9A%A9.git%2Fobjec-2"><colgroup><col></col><col></col></colgroup><tbody><tr><th>구성 요소

</th><th>변화 내용

</th></tr><tr><td>`<span class="editor-theme-code">.git/objects/</span>`

</td><td>****revert용 새 커밋 객체****<span style="white-space: pre-wrap;"> 생성</span>

</td></tr><tr><td>`<span class="editor-theme-code">.git/index</span>`

</td><td>C의 반대 연산 내용 반영

</td></tr><tr><td>`<span class="editor-theme-code">.git/HEAD</span>`

</td><td>새 커밋으로 이동

</td></tr></tbody></table>

> `<span class="editor-theme-code">revert</span>`<span style="white-space: pre-wrap;">는 원본 커밋을 삭제하지 않고, </span>****"반대로 되돌리는" 커밋****을 추가한다.

### 6.3 도식 예시

```
A---B---C ← HEAD

▶ git revert C

결과:

A---B---C---C' ← HEAD (C를 무효화하는 커밋)
```

---

## 7. 특수 파일 요약 (2부)

<table id="bkmrk-%ED%8C%8C%EC%9D%BC-%EC%9D%B4%EB%A6%84%EC%83%9D%EC%84%B1-%EB%AA%85%EB%A0%B9%EC%96%B4%EC%84%A4%EB%AA%85.git%2Fch"><colgroup><col></col><col></col><col></col></colgroup><tbody><tr><th>파일 이름

</th><th>생성 명령어

</th><th>설명

</th></tr><tr><td>`<span class="editor-theme-code">.git/CHERRY_PICK_HEAD</span>`

</td><td>`<span class="editor-theme-code">git cherry-pick</span>`

</td><td>적용 중인 커밋 해시 저장 (충돌 시 사용)

</td></tr><tr><td>`<span class="editor-theme-code">.git/REVERT_HEAD</span>`

</td><td>`<span class="editor-theme-code">git revert</span>`<span style="white-space: pre-wrap;"> (중단 시)</span>

</td><td>revert 진행 중인 커밋 정보

</td></tr><tr><td>`<span class="editor-theme-code">.git/refs/stash</span>`

</td><td>`<span class="editor-theme-code">git stash</span>`

</td><td>가장 최근 stash 참조

</td></tr><tr><td>`<span class="editor-theme-code">.git/logs/refs/stash</span>`

</td><td>`<span class="editor-theme-code">git stash</span>`

</td><td>stash 추가 이력 저장

</td></tr></tbody></table>

---

## 8. 요약 비교표 (2부)

<table id="bkmrk-%EB%AA%85%EB%A0%B9%EC%96%B4%EC%83%88-%EC%BB%A4%EB%B0%8B-%EC%83%9D%EC%84%B1%EA%B8%B0%EC%A1%B4-%EC%BB%A4%EB%B0%8B-%EC%82%AD%EC%A0%9Che"><colgroup><col></col><col></col><col></col><col></col><col></col><col></col></colgroup><tbody><tr><th>명령어

</th><th>새 커밋 생성

</th><th>기존 커밋 삭제

</th><th>HEAD 이동

</th><th>특수 파일

</th><th>비고

</th></tr><tr><td>`<span class="editor-theme-code">stash</span>`

</td><td>O (임시 커밋)

</td><td>❌

</td><td>❌

</td><td>`<span class="editor-theme-code">refs/stash</span>`

</td><td>작업 보관

</td></tr><tr><td>`<span class="editor-theme-code">cherry-pick</span>`

</td><td>O

</td><td>❌

</td><td>O

</td><td>`<span class="editor-theme-code">CHERRY_PICK_HEAD</span>`

</td><td>선택 커밋 복사

</td></tr><tr><td>`<span class="editor-theme-code">revert</span>`

</td><td>O

</td><td>❌

</td><td>O

</td><td>`<span class="editor-theme-code">REVERT_HEAD</span>`

</td><td>기존 커밋 반전

</td></tr></tbody></table>

---

# 도식화

---

## 1. 전체 구조 개요

```
.git/
├── HEAD                  ← 현재 가리키는 브랜치 (예: ref: refs/heads/main)
├── config                ← 로컬 Git 설정
├── description           ← 주로 bare repo에서 사용
├── index                 ← 스테이징 영역 정보 (트래킹 중인 파일 목록)
├── objects/              ← Git 객체 저장소 (blob, tree, commit, tag)
│   ├── xx/xxxx...        ← SHA-1 해시로 저장된 개별 객체
│   └── pack/             ← 압축된 객체 저장소 (.pack, .idx)
├── refs/                 ← 브랜치, 태그 등 참조(포인터)
│   ├── heads/            ← 브랜치 참조 (예: main, feature)
│   ├── remotes/          ← 원격 브랜치 정보 (예: origin/main)
│   └── tags/             ← 태그 정보
├── logs/                 ← HEAD 및 refs의 이동 이력 (reflog 저장소)
│   ├── HEAD
│   └── refs/
├── info/                 ← exclude 설정 등 부가 정보
└── hooks/                ← 커밋, 푸시 등 Git 이벤트용 스크립트
```

---

## 2. 각 구성 요소 설명

### <span style="white-space: pre-wrap;">🔹 </span>`<span class="editor-theme-code">.git/HEAD</span>`

- 현재 Git이 바라보는 위치
- <span style="white-space: pre-wrap;">대부분 </span>`<span class="editor-theme-code">ref: refs/heads/main</span>`<span style="white-space: pre-wrap;"> 형태</span>
- ****HEAD → 브랜치 → 커밋****

### <span style="white-space: pre-wrap;">🔹 </span>`<span class="editor-theme-code">.git/objects/</span>`

- <span style="white-space: pre-wrap;">Git의 핵심: 모든 파일/폴더/커밋을 </span>****SHA-1 해시값****으로 저장
- 하위 폴더 + 해시 기반 객체들

```bash
.git/objects/
├── a7/...
├── d1/...
└── pack/    ← packfile 압축 저장소
```

### <span style="white-space: pre-wrap;">🔹 </span>`<span class="editor-theme-code">.git/refs/</span>`

- 브랜치/태그가 어떤 커밋을 가리키는지 저장

```
.git/refs/heads/main → a1b2c3d4e5 (커밋 해시)
```

### <span style="white-space: pre-wrap;">🔹 </span>`<span class="editor-theme-code">.git/logs/</span>`

- `<span class="editor-theme-code">git reflog</span>`<span style="white-space: pre-wrap;"> 명령에서 쓰이는 내부 이력</span>
- `<span class="editor-theme-code">HEAD</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">branches</span>`<span style="white-space: pre-wrap;">, </span>`<span class="editor-theme-code">remotes</span>`<span style="white-space: pre-wrap;"> 이동 내역 저장</span>

### <span style="white-space: pre-wrap;">🔹 </span>`<span class="editor-theme-code">.git/index</span>`

- 스테이징 영역(index)의 내부 상태를 저장하는 바이너리 파일
- `<span class="editor-theme-code">git add</span>`<span style="white-space: pre-wrap;"> → index에 등록 → </span>`<span class="editor-theme-code">git commit</span>`<span style="white-space: pre-wrap;"> 때 커밋됨</span>

### <span style="white-space: pre-wrap;">🔹 </span>`<span class="editor-theme-code">.git/hooks/</span>`

- 커밋/푸시/머지 전후에 실행되는 자동화 스크립트

```text
pre-commit, post-commit, pre-push 등
```

---

## 3. 핵심 흐름

```text
📁 Working Directory
   ↓ git add
📂 .git/index (Staging Area)
   ↓ git commit
📦 .git/objects/ (커밋, 트리, 블롭 저장)
   ↓ 브랜치 포인터 이동
📄 .git/refs/heads/main
   ↑ HEAD → 현재 브랜치 참조
```

---

## 요약

<table id="bkmrk-%EA%B5%AC%EC%84%B1%EC%9A%94%EC%86%8C%EC%84%A4%EB%AA%85head%ED%98%84%EC%9E%AC-%EB%B8%8C%EB%9E%9C%EC%B9%98-%EB%98%90%EB%8A%94-"><colgroup><col></col><col></col></colgroup><tbody><tr><th>구성요소

</th><th>설명

</th></tr><tr><td>`<span class="editor-theme-code">HEAD</span>`

</td><td>현재 브랜치 또는 커밋을 가리킴

</td></tr><tr><td>`<span class="editor-theme-code">refs</span>`

</td><td>브랜치/태그 → 커밋 연결

</td></tr><tr><td>`<span class="editor-theme-code">objects</span>`

</td><td>모든 데이터(SHA-1 기반) 저장소

</td></tr><tr><td>`<span class="editor-theme-code">index</span>`

</td><td>스테이징 상태 추적

</td></tr><tr><td>`<span class="editor-theme-code">logs</span>`

</td><td>HEAD 및 브랜치 이동 이력 (reflog)

</td></tr><tr><td>`<span class="editor-theme-code">hooks</span>`

</td><td>Git 이벤트 발생 시 실행되는 스크립트

</td></tr></tbody></table>

---

# 마인드맵

---

```
Git 내부 구조
├── 1. Working Directory
│   └── 실제 작업 공간 (코드 작성, 수정)
│
├── 2. Index (Staging Area) ← .git/index
│   └── git add로 관리됨
│
├── 3. Local Repository (.git/)
│   ├── 3.1 objects/
│   │   ├── blob: 파일 내용
│   │   ├── tree: 디렉토리 구조
│   │   └── commit: 스냅샷 + 부모 참조 + 메타
│   │
│   ├── 3.2 refs/
│   │   ├── heads/: 브랜치 포인터
│   │   ├── remotes/: 원격 브랜치
│   │   └── tags/: 태그 포인터
│   │
│   ├── 3.3 HEAD
│   │   ├── 현재 브랜치 참조 (예: ref: refs/heads/main)
│   │   └── detached 상태 가능
│   │
│   ├── 3.4 logs/
│   │   └── HEAD 및 refs의 이동 이력 (reflog)
│   │
│   ├── 3.5 config
│   │   └── 사용자 설정 정보
│   │
│   ├── 3.6 hooks/
│   │   └── pre-commit, post-commit 등 자동화 스크립트
│   │
│   └── 3.7 특수 HEAD 파일
│       ├── MERGE_HEAD        ← merge 중 생성
│       ├── REBASE_HEAD       ← rebase 중 생성
│       ├── ORIG_HEAD         ← reset 전 위치 백업
│       ├── CHERRY_PICK_HEAD  ← cherry-pick 중 충돌 시
│       ├── REVERT_HEAD       ← revert 충돌 시
│       └── FETCH_HEAD        ← fetch 결과
│
├── 4. 명령어 동작 흐름
│   ├── git add
│   │   └── 파일 → index 등록
│   ├── git commit
│   │   ├── index → commit 객체 생성
│   │   └── 브랜치 포인터 → 새 커밋
│   ├── git reset
│   │   ├── HEAD/브랜치 포인터 이동
│   │   └── --hard 시 index + 작업 디렉토리도 초기화
│   ├── git merge
│   │   ├── merge commit 생성
│   │   └── MERGE_HEAD 기록
│   ├── git rebase
│   │   ├── 커밋 재작성 (rewrite)
│   │   └── REBASE_HEAD 기록
│   ├── git cherry-pick
│   │   ├── 커밋 복사
│   │   └── CHERRY_PICK_HEAD 기록
│   ├── git revert
│   │   ├── 반전 커밋 추가
│   │   └── REVERT_HEAD 기록
│   └── git stash
│       ├── 현재 상태를 임시 커밋으로 보관
│       ├── refs/stash 생성
│       └── logs/refs/stash 이력 저장
│
└── 5. 복구 및 확인
    ├── git reflog  → HEAD, 브랜치 이동 이력 추적
    ├── git log     → 커밋 히스토리
    ├── git cat-file -p <해시> → 객체 내용 확인
    └── git fsck     → 저장소 무결성 점검
```

---

## 요약

<table id="bkmrk-%ED%82%A4%EC%9B%8C%EB%93%9C%EC%9D%98%EB%AF%B8blob%ED%8C%8C%EC%9D%BC-%EB%82%B4%EC%9A%A9tree%ED%8F%B4%EB%8D%94"><colgroup><col></col><col></col></colgroup><tbody><tr><th>키워드

</th><th>의미

</th></tr><tr><td>blob

</td><td>파일 내용

</td></tr><tr><td>tree

</td><td>폴더 구조

</td></tr><tr><td>commit

</td><td>전체 스냅샷

</td></tr><tr><td>HEAD

</td><td>현재 위치 추적 포인터

</td></tr><tr><td>refs

</td><td>브랜치/태그가 가리키는 대상

</td></tr><tr><td>logs

</td><td>HEAD/브랜치 이동 기록 (reflog)

</td></tr><tr><td>index

</td><td>커밋 준비 상태 저장

</td></tr><tr><td>stash

</td><td>작업 보관소 (임시 커밋)

</td></tr></tbody></table>

---