고급 Git: 내부 원리와 고급 명령어

┌──────────────────────────────────────────────┐
│                   Commit                      │
│  tree: abc123...                              │
│  parent: def456...                            │
│  author: jk <jk@email.com> 1707523200 +0900  │
│  message: "feat: add payment module"          │
└──────────────┬───────────────────────────────┘
               │
               ▼
┌──────────────────────────────────────────────┐
│                    Tree                       │
│  blob a1b2c3  README.md                      │
│  blob d4e5f6  package.json                   │
│  tree 789abc  src/                            │
└──────┬────────────────────┬──────────────────┘
       │                    │
       ▼                    ▼
┌─────────────┐   ┌────────────────────┐
│    Blob     │   │       Tree         │
│ (파일 내용)  │   │  blob ff00aa app.ts│
│             │   │  blob bb11cc db.ts │
└─────────────┘   └────────────────────┘

# 커밋 객체 내용 보기
git cat-file -p HEAD
 
# 트리 객체 내용 보기
git cat-file -p HEAD^{tree}
 
# 블롭 객체 내용 보기 (특정 파일)
git cat-file -p HEAD:src/app.ts
 
# 객체 타입 확인
git cat-file -t abc1234

.git/refs/
├── heads/          # 로컬 브랜치
│   ├── main        # → commit hash
│   └── feature/auth # → commit hash
├── tags/           # 태그
│   └── v1.0.0      # → commit hash (or tag object)
└── remotes/        # 원격 추적 브랜치
    └── origin/
        └── main    # → commit hash

# HEAD 확인
cat .git/HEAD
# ref: refs/heads/main
 
# 브랜치가 가리키는 커밋 확인
cat .git/refs/heads/main
# a1b2c3d4e5f6...

main:    A ─── B ─── C ──────── M (merge commit)
                      \        /
feature:               D ─── E

main:    A ─── B ─── C
                      \
feature:               D' ─── E' (새 커밋 해시)

git rebase -i HEAD~5

pick   abc1234 feat: add user model
squash def5678 fix: typo in user model      # 이전 커밋과 합침
pick   ghi9012 feat: add user repository
reword jkl3456 feat: add user service        # 메시지만 수정
drop   mno7890 WIP: debugging                # 커밋 삭제

# 단일 커밋 cherry-pick
git cherry-pick abc1234
 
# 여러 커밋 cherry-pick
git cherry-pick abc1234 def5678
 
# 범위 cherry-pick (abc1234 미포함, def5678 포함)
git cherry-pick abc1234..def5678
 
# 커밋하지 않고 변경사항만 스테이징
git cherry-pick --no-commit abc1234

# bisect 시작
git bisect start
 
# 현재 버전이 버그가 있음을 표시
git bisect bad
 
# 알려진 정상 버전을 표시
git bisect good v1.0.0
 
# Git이 중간 커밋으로 자동 체크아웃
# 테스트 후 결과 입력
git bisect good   # 이 커밋은 정상
# 또는
git bisect bad    # 이 커밋은 버그 있음
 
# Git이 다시 중간 커밋으로 체크아웃...
# 반복하면 O(log n)으로 버그 커밋 특정
 
# bisect 종료
git bisect reset

# 테스트 스크립트로 자동 bisect
# 스크립트 종료 코드: 0 = good, 1 = bad
git bisect start HEAD v1.0.0
git bisect run ./test-for-bug.sh

# 현재 변경사항 임시 저장
git stash
 
# 메시지와 함께 저장
git stash save "WIP: payment integration"
 
# untracked 파일도 포함하여 저장
git stash -u
 
# stash 목록 확인
git stash list
# stash@{0}: On feature/auth: WIP: payment integration
# stash@{1}: On main: debugging session
 
# 가장 최근 stash 적용 (stash 유지)
git stash apply
 
# 가장 최근 stash 적용 후 삭제
git stash pop
 
# 특정 stash 적용
git stash apply stash@{2}
 
# stash를 새 브랜치로 적용
git stash branch new-branch-name
 
# stash 내용 확인
git stash show -p stash@{0}
 
# 특정 stash 삭제
git stash drop stash@{0}
 
# 모든 stash 삭제
git stash clear

# HEAD 이동 이력 확인
git reflog
# a1b2c3d HEAD@{0}: commit: feat: add payment
# d4e5f6g HEAD@{1}: checkout: moving from main to feature
# h7i8j9k HEAD@{2}: reset: moving to HEAD~3
# l0m1n2o HEAD@{3}: commit: feat: add user model
 
# 특정 브랜치의 reflog
git reflog show feature/auth
 
# 삭제된 커밋 복구
git checkout HEAD@{3}
# 또는
git branch recovered-branch HEAD@{3}
 
# 잘못된 reset 되돌리기
git reset --hard HEAD@{2}

# 새 워크트리 생성 (기존 브랜치)
git worktree add ../project-hotfix hotfix/payment-bug
 
# 새 워크트리 + 새 브랜치 생성
git worktree add -b feature/new-api ../project-new-api
 
# 워크트리 목록 확인
git worktree list
# /Users/jk/project          abc1234 [main]
# /Users/jk/project-hotfix   def5678 [hotfix/payment-bug]
# /Users/jk/project-new-api  ghi9012 [feature/new-api]
 
# 워크트리 제거
git worktree remove ../project-hotfix
 
# 스테일 워크트리 정리
git worktree prune

# Git LFS 설치 및 초기화
git lfs install
 
# 대용량 파일 패턴 추적
git lfs track "*.psd"
git lfs track "*.zip"
git lfs track "data/**"
 
# .gitattributes에 패턴이 기록됨
cat .gitattributes
# *.psd filter=lfs diff=lfs merge=lfs -text
# *.zip filter=lfs diff=lfs merge=lfs -text
 
# .gitattributes를 커밋
git add .gitattributes
git commit -m "chore: configure Git LFS"
 
# 이후 일반적으로 add/commit/push하면 자동으로 LFS 처리
git add design.psd
git commit -m "feat: add design asset"
git push

리포지토리 (.git)             LFS 서버 (외부)
┌─────────────────┐     ┌──────────────────┐
│ 포인터 파일       │     │ 실제 파일 내용     │
│ (SHA-256 해시,   │ ──→ │ design.psd       │
│  크기 등 메타데이터)│     │ (원본 바이너리)    │
└─────────────────┘     └──────────────────┘

# 특정 파일의 전체 히스토리 삭제 (실수로 커밋된 비밀 키 등)
git filter-repo --path secrets.env --invert-paths
 
# 특정 디렉토리만 남기고 나머지 삭제 (모노레포 분리)
git filter-repo --path src/auth-service/ --path-rename src/auth-service/:
 
# 이메일 주소 일괄 변경
git filter-repo --email-callback '
    return email.replace(b"old@company.com", b"new@company.com")
'
 
# 대용량 파일 식별
git filter-repo --analyze

느슨한 객체들 (초기)
.git/objects/
├── a1/b2c3d4...  (blob)
├── d4/e5f6g7...  (blob)
└── ...
 
팩파일 (압축 후)
.git/objects/pack/
├── pack-abc123.pack  (객체 데이터)
└── pack-abc123.idx   (인덱스 -- 빠른 탐색)

# 수동 팩파일 생성
git gc
 
# 리포지토리 크기 확인
git count-objects -vH
 
# 팩파일 통계
git verify-pack -v .git/objects/pack/pack-*.idx | head -20

# 최근 1개 커밋만 클론 (히스토리 불필요 시)
git clone --depth 1 https://github.com/org/monorepo.git
 
# 필요 시 히스토리 추가 fetch
git fetch --unshallow

# sparse-checkout 초기화
git sparse-checkout init --cone
 
# 필요한 디렉토리만 체크아웃
git sparse-checkout set services/auth-service shared/common
 
# 추가
git sparse-checkout add services/payment-service
 
# 현재 설정 확인
git sparse-checkout list

# 블롭 없이 클론 (필요할 때 자동 다운로드)
git clone --filter=blob:none https://github.com/org/monorepo.git
 
# 트리도 제외하여 최소한으로 클론
git clone --filter=tree:0 https://github.com/org/monorepo.git

# 최적 조합: 부분 클론 + Sparse Checkout
git clone --filter=blob:none --sparse https://github.com/org/monorepo.git
cd monorepo
git sparse-checkout set services/my-service shared/utils