git commit하면 .git 안에서 무슨 일이 벌어질까?

들어가며

프로젝트 버전 관리를 위해 우리 모두 Git을 쓰지만, 정작 .git 폴더 안을 열어본 적은 별로 없을 거예요.

사실 저도 그랬습니다. git commit 하면 저장되고, git push 하면 올라가고 그 정도만 알고도 쓰는 데 전혀 지장이 없었거든요.

이번 포스트에서는 .git 폴더를 살펴보며 커밋할 때마다 내부가 어떻게 변해가는지 하나씩 살펴보겠습니다!

---

Repository 생성

shu@sHu-MacBook-Pro Source Code % git init
Initialized empty Git repository in /Users/shu/Desktop/Source Code/ossca/.git/

shu@sHus-MacBook-Pro .git % cd git && ll
total 24
drwxr-xr-x   9 shu  staff  288  4 23 23:48 ./
drwxr-xr-x   3 shu  staff   96  4 23 23:48 ../
-rw-r--r--   1 shu  staff  137  4 23 23:48 config
-rw-r--r--   1 shu  staff   73  4 23 23:48 description
-rw-r--r--   1 shu  staff   21  4 23 23:48 HEAD
drwxr-xr-x  15 shu  staff  480  4 23 23:48 hooks/
drwxr-xr-x   3 shu  staff   96  4 23 23:48 info/
drwxr-xr-x   4 shu  staff  128  4 23 23:48 objects/
drwxr-xr-x   4 shu  staff  128  4 23 23:48 refs/

git init 명령어를 통해 repository를 생성하게 되면 이처럼 .git 폴더가 생성이 됩니다.

git 폴더 안에는 여러 개의 폴더와 파일들로 구성되어 있는데, 이번에 집중적으로 볼 건 objects 폴더에요!

objects 폴더는 실제 데이터가 저장되는 곳이에요. 파일 내용, 디렉토리 구조, 커밋 정보가 전부 여기 들어있어요!
각각 blob, tree, commit 이라는 타입으로 구분되서 저장되어요.

refs 폴더는 브랜치나 태그가 어떤 커밋을 가리키는지 저장하는 곳이에요.

---

Working Directory → Staging Area 

shu@sHus-MacBook-Pro ossca % echo "hello, World" | tee first.txt > /dev/null
shu@sHus-MacBook-Pro ossca % git add first.txt 
shu@sHus-MacBook-Pro ossca % git status
On branch main

No commits yet

Changes to be committed:
  (use "git rm --cached <file>..." to unstage)
        new file:   first.txt
        
shu@sHus-MacBook-Pro ossca % cd .git/objects/bd && ll
total 8
drwxr-xr-x  3 shu  staff   96  4 26 20:34 ./
drwxr-xr-x  5 shu  staff  160  4 26 20:34 ../
-r--r--r--  1 shu  staff   29  4 26 20:34 c395c2a4533f9951b648b5234f435935e526a8

텍스트 파일을 생성하고 git add 명령어로 해당 파일을 Staging Area로 올리게 되면 objects 폴더 내에 파일이 생성되어요

이 파일은 해당 텍스트 파일에 대한 상태를 저장하고 있어요!

 

파일 내용을 SHA-1 해싱하여 나온 40자리 중 맨 처음 2자리를 폴더명 / 나머지 38자리를 파일명으로 사용해요.

위의 first.txt 파일에 대한 SHA-1 해싱값은 "bdc395c2a4533f9951b648b5234f435935e526a8" 라고 볼 수 있어요.

 

또한, 해당 파일은 데이터 공간을 절약하기 위해 zlib 형식으로 압축되어 있기 때문에 아래의 파이썬 코드를 통해 원문 내용을 확인할 수 있어요!

import zlib

file_path = "c395c2a4533f9951b648b5234f435935e526a8" 
decom_content = zlib.decompress(open(file_path, "rb").read())

print(decom_content)

# [결과] b'blob 13\x00hello, World\n'

텍스트 파일을 'git restore --staged first.txt' 명령어를 통해 Working Directory로 바꾸어도 objects 폴더 내 파일은 삭제되지 않아요.
git의 object store는 'append-only' 방식을 취하고 있기 때문에 한 번 생긴 파일은 GC에 의해 삭제되기 전까진 유지되어요.

---

Staging Area → Repository

shu@sHus-MacBook-Pro ossca % git add first.txt 
shu@sHus-MacBook-Pro ossca % git commit -m "first commit"
[main (root-commit) fffc3b9] first commit
 1 file changed, 1 insertion(+)
 create mode 100644 first.txt
 
shu@sHus-MacBook-Pro ossca % git log
commit fffc3b97302a953e011f55246de5069d8adc2e53 (HEAD -> main)
Author: xxx <xxx@xxxx.xxxx>
Date:   Sun Apr 26 20:57:48 2026 +0900

    first commit
    
shu@sHus-MacBook-Pro ossca % cd .git/objects && ll
total 0
drwxr-xr-x   7 shu  staff  224  4 26 20:57 ./
drwxr-xr-x  12 shu  staff  384  4 26 20:57 ../
drwxr-xr-x   3 shu  staff   96  4 26 20:57 60/
drwxr-xr-x   3 shu  staff   96  4 26 20:34 bd/
drwxr-xr-x   3 shu  staff   96  4 26 20:57 ff/
drwxr-xr-x   2 shu  staff   64  4 26 20:33 info/
drwxr-xr-x   2 shu  staff   64  4 26 20:33 pack/

shu@sHus-MacBook-Pro objects % ls bd/
c395c2a4533f9951b648b5234f435935e526a8

shu@sHus-MacBook-Pro objects % ls 60/
e8a3a28d414830db8c260a265b5d027fe59fec

shu@sHus-MacBook-Pro objects % ls ff/
fc3b97302a953e011f55246de5069d8adc2e53

git commit 명령어로 커밋을 하게 되면 objects 폴더 내에 2개의 파일이 더 추가되어요. (60/, ff/)

지금까지 'git add + git commit' 을 통해 objects 폴더 내에 총 3가지의 파일이 생성이 되었는데 각 파일들에 대해 알아보아요!

 

1️⃣ Blob

import zlib

file_path = "c395c2a4533f9951b648b5234f435935e526a8" 
decom_content = zlib.decompress(open(file_path, "rb").read())

print(decom_content)
b'blob 13\x00hello, World\n'

gid add 시점에 생성된 파일이에요. 파일명이나 경로는 전혀 포함되어 있지 않고 오직 파일 내용만 저장하고 있어요!

 

 

2️⃣ Tree

import zlib

file_path = "e8a3a28d414830db8c260a265b5d027fe59fec" 
decom_content = zlib.decompress(open(file_path, "rb").read())

print(decom_content)
b'tree 37\x00100644 first.txt\x00\xbd\xc3\x95\xc2\xa4S?\x99Q\xb6H\xb5#OCY5\xe5&\xa8'

Blob 만으로는 이 파일 내용이 어떤 파일에 대한 상태를 관리하는지 알 수 없어서 Tree가 파일명과 Blob을 연결해주는 매핑테이블 역할을 해요.

Tree 정보를 아래처럼 읽을 수 있어요!

 

👉 tree 37 = 오브젝트 타입 + 크기

👉 \x00 = 구분자

👉 100644 = 파일 권한

👉 first.txt = 파일명

👉 \x00 = 구분자

👉 \xbd\xc3\x95\xc2\xa4S?\x99Q\xb6H\xb5#OCY5\xe5&\xa8 = blob 해시 (바이너리 20byte)

 

✅ 파일이 여러 개면 파일 수만큼 줄이 늘어나고 파일이 많아질수록 Tree 오브젝트의 크기도 커지게 되어요.

✅ 또한 파일이 폴더인 경우, blob 대신 또 다른 Tree를 가리켜요. (Tree가 Tree를 가리키는 방식으로 계층 구조를 표현해요!)

 

 

3️⃣  Commit

import zlib

file_path = "fc3b97302a953e011f55246de5069d8adc2e53" 
decom_content = zlib.decompress(open(file_path, "rb").read())

print(decom_content)
b'commit 209\x00tree 60e8a3a28d414830db8c260a265b5d027fe59fec\nauthor \xe1\x84\x87\xe1\x85\xa1\xe1\x86\xa8\xe1\x84\x89\xe1\x85\xa5\xe1\x86\xbc\xe1\x84\x89\xe1\x85\xae <ssp0622@diffchild.com> 1777204668 +0900\ncommitter \xe1\x84\x87\xe1\x85\xa1\xe1\x86\xa8\xe1\x84\x89\xe1\x85\xa5\xe1\x86\xbc\xe1\x84\x89\xe1\x85\xae <xxxxx@xxxxx.xxxxx> 1777204668 +0900\n\nfirst commit\n'

Tree 오브젝트를 가리키면서 작성자, 시간, 커밋 메시지 등의 정보를 담고 있어요.

흔히 git log 에서 보는 커밋 해시가 바로 이 commit 오브젝트의 경로라고 볼수 있어요.

Commit 정보를 아래처럼 읽을 수 있어요!

 

👉 commit 209 = 오브젝트 타입 + 크기

👉 \x00 = 구분자

👉 tree 60e8a3a28d414830db8c260a265b5d027fe59fec = Tree 해시

👉 author ... = 작성자 + 시간 (Unix timestamp)

👉 committer = 커미터 + 시간

👉 first commit = 커밋 메시지

 

지금까지 살펴본 Blob, Tree, Commit 세 오브젝트의 관계를 아래와 같이 정리할 수 있어요.

 

 

마치며

.git 폴더를 직접 뜯어보기 전까지는 그냥 "어딘가에 저장되겠지" 하고 넘겼는데, 이번 블로깅을 통해 내부 동작 과정을 알게 됐어요.

git add 하는 순간 이미 blob 오브젝트가 생기고, git commit 하면 tree, commit 오브젝트가 체인으로 연결되고, 그리고 우리가 당연하게 쓰던 브랜치도 결국 특정 커밋 해시를 가리키는 포인터에 불과하다는 것도요.

 

알고 보면 되게 단순한 구조인데, 결국 단순함이 git을 더 강력하게 만드는 이유라고 생각해요.

단순히, 명령어만 외워서 썼던 시절과 달리 이제는 제대로 이해하고 쓰는 느낌이 들어서 좋았습니다!