Git 완전 정복: 주니어부터 시니어까지, 실무에서 바로 쓰는 Git 고급 워크플로우

# 파일 내용의 해시값 확인
echo "Hello, Git!" | git hash-object --stdin
# 결과: 예시 af5626b4a114abcb82d63db7c8082c3c4756e51b

# 실제 저장된 객체 타입 확인
git cat-file -t af5626b
# 결과: blob

# 내용 확인
git cat-file -p af5626b
# 결과: Hello, Git!

# 최신 커밋의 트리 확인
git cat-file -p HEAD^{tree}
# 100644 blob a906cb2a4a904a15...    README.md
# 040000 tree 99f1a6d12cb4b6f1...    src
# 100644 blob 47c6340d6459e058...    package.json

# 커밋 내부 구조 확인
git cat-file -p HEAD
# tree 99f1a6d12cb4b6f19c8655fca46c3ecf317074e0
# parent 8bd3ad5e1234567890abcdef1234567890abcdef
# author John Doe <john@example.com> 1711100000 +0900
# committer John Doe <john@example.com> 1711100000 +0900
#
# feat: add user authentication

# 어노테이티드 태그 생성
git tag -a v1.0.0 -m "Release version 1.0.0"

# 태그 객체 확인
git cat-file -p v1.0.0

# 동일한 내용 = 동일한 해시
echo "same content" | git hash-object --stdin
echo "same content" | git hash-object --stdin
# 두 결과가 완전히 동일합니다

    A---B---C---D  (main)
         \
          E---F---G  (feature)
               \
                H---I  (hotfix)

# 그래프 형태로 로그 보기
git log --oneline --graph --all --decorate

# 더 깔끔한 출력
git log --oneline --graph --all --format="%h %s (%ar)"

.git/
  HEAD          # 현재 브랜치를 가리키는 포인터
  config        # 저장소별 설정
  refs/
    heads/      # 로컬 브랜치들 (각 파일 = 커밋 해시)
    tags/       # 태그들
    remotes/    # 원격 브랜치 추적
  objects/      # 모든 Git 객체 (blob, tree, commit, tag)
    pack/       # 압축된 객체 팩 파일
  hooks/        # Git 훅 스크립트
  index         # 스테이징 영역 (바이너리)

# HEAD가 가리키는 곳 확인
cat .git/HEAD
# ref: refs/heads/main

# main 브랜치가 가리키는 커밋
cat .git/refs/heads/main
# a1b2c3d4e5f6...

# 객체 저장소 크기 확인
git count-objects -vH

main ─────────────────────────────── (프로덕션)
  │
  └── develop ────────────────────── (개발 통합)
        │        │
        │   feature/login ────────── (기능 개발)
        │
        └── release/1.0 ──────────── (릴리스 준비)
              │
              └── hotfix/bug-123 ──── (긴급 수정)

# Git Flow 초기화 (git-flow 확장)
git flow init

# 기능 개발 시작
git flow feature start user-auth

# 기능 개발 완료
git flow feature finish user-auth

main ────────────────────────────────
  │              │
  └── feature ───┘ (PR + 머지)

# 1. 브랜치 생성
git checkout -b feature/add-search

# 2. 작업 및 커밋
git add .
git commit -m "feat: add search functionality"

# 3. 푸시
git push -u origin feature/add-search

# 4. PR 생성 (GitHub CLI)
gh pr create --title "Add search functionality" --body "..."

# 5. 리뷰 후 머지
gh pr merge --squash

main ──A──B──C──D──E──F──G──H──I──
            \─/     \─/
         (1-2일)  (1-2일)

# 기능 개발
feature/JIRA-123-add-login
feature/user-profile-page

# 버그 수정
bugfix/JIRA-456-fix-null-pointer
fix/login-redirect-loop

# 핫픽스
hotfix/security-patch-xss
hotfix/v1.2.1

# 릴리스
release/1.0.0
release/2026-q1

# 실험/개인
experiment/new-search-algo
chore/update-dependencies

git checkout main
git merge feature/login
# 머지 커밋이 생성됨

    A---B---C---D---M  (main, 머지 커밋 M)
         \         /
          E---F---G  (feature)

git checkout feature/login
git rebase main
# feature의 커밋이 main 위에 재적용됨

    A---B---C---D  (main)
                 \
                  E'---F'---G'  (feature, 재적용됨)

# 최근 5개 커밋을 대화형으로 편집
git rebase -i HEAD~5

pick a1b2c3d feat: add user model
pick d4e5f6g fix: typo in user model
pick h7i8j9k feat: add user controller
pick l0m1n2o WIP: debugging
pick p3q4r5s feat: add user routes

pick a1b2c3d feat: add user model
fixup d4e5f6g fix: typo in user model
pick h7i8j9k feat: add user controller
drop l0m1n2o WIP: debugging
pick p3q4r5s feat: add user routes

# 원래 커밋
git commit -m "feat: add user model"

# 나중에 수정이 필요할 때
git commit --fixup HEAD
# 또는 특정 커밋 지정
git commit --fixup a1b2c3d

# 자동으로 정리
git rebase -i --autosquash main

# 안전한 리베이스 (개인 feature 브랜치)
git checkout feature/my-task
git rebase main

# 위험한 리베이스 (절대 하지 마세요)
git checkout main
git rebase feature/something  # 금지!

# 방금 한 커밋의 메시지 수정 (아직 푸시 안 함)
git commit --amend -m "feat: add user authentication"

# 에디터에서 메시지 수정
git commit --amend

# 상황: main에 커밋해야 할 것을 feature 브랜치에 했다
# 방법 1: cherry-pick
git checkout main
git cherry-pick abc1234
git checkout feature/wrong-branch
git reset --hard HEAD~1

# 방법 2: stash 활용
git reset --soft HEAD~1
git stash
git checkout correct-branch
git stash pop
git commit -m "correct commit message"

# 안전한 방법: revert (새 커밋으로 되돌림, 히스토리 보존)
git revert abc1234
git push

# 위험한 방법: reset + force push (히스토리 변경)
git reset --hard HEAD~1
git push --force-with-lease
# force-with-lease는 다른 사람의 커밋을 덮어쓰지 않도록 보호

# 충돌 발생 시
git merge feature/login
# CONFLICT (content): Merge conflict in src/auth.js

# 충돌 파일 확인
git status

# 충돌 마커 구조
# <<<<<<< HEAD
# 현재 브랜치의 코드
# =======
# 머지하려는 브랜치의 코드
# >>>>>>> feature/login

# 수동 해결 후
git add src/auth.js
git commit -m "resolve merge conflict in auth module"

# 1. main을 자주 가져와서 동기화
git fetch origin
git rebase origin/main

# 2. 작은 단위로 자주 커밋하고 머지
# 3. 팀 내 파일 소유권 명확히 하기 (CODEOWNERS)
# 4. 머지 도구 설정
git config --global merge.tool vimdiff
git mergetool

# bisect 시작
git bisect start

# 현재(버그 있음)를 bad로 표시
git bisect bad

# 버그 없던 커밋을 good으로 표시
git bisect good v1.0.0

# Git이 중간 커밋을 체크아웃 — 테스트 후 판단
git bisect good  # 또는 git bisect bad

# 반복하면 버그를 유발한 정확한 커밋을 찾음
# 결과: abc1234 is the first bad commit

# bisect 종료
git bisect reset

# 테스트 스크립트가 실패하면 bad, 성공하면 good
git bisect start HEAD v1.0.0
git bisect run npm test
# 자동으로 버그 커밋을 찾아줍니다!

# 방법 1: git-filter-repo (추천)
pip install git-filter-repo
git filter-repo --path large-file.zip --invert-paths

# 방법 2: BFG Repo-Cleaner
java -jar bfg.jar --delete-files large-file.zip
git reflog expire --expire=now --all
git gc --prune=now --aggressive

# 예방: .gitignore 설정
echo "*.zip" >> .gitignore
echo "*.tar.gz" >> .gitignore
echo "node_modules/" >> .gitignore

# 파일의 변경사항을 hunk 단위로 선택적 스테이징
git add -p src/utils.js

# 각 hunk에 대해:
# y - 이 hunk 스테이징
# n - 이 hunk 건너뛰기
# s - 더 작은 hunk로 분할
# e - 수동으로 편집
# q - 종료

# 방법 1: stash
git stash push -m "WIP: feature work"
git checkout main
git checkout -b hotfix/critical-bug
# 핫픽스 작업...
git checkout feature/my-work
git stash pop

# 방법 2: worktree (더 나은 방법!)
git worktree add ../hotfix-workspace main
cd ../hotfix-workspace
git checkout -b hotfix/critical-bug
# 핫픽스 작업...
cd ../main-workspace
git worktree remove ../hotfix-workspace

# 방법 1: interactive rebase
git rebase -i HEAD~4
# 첫 번째를 pick, 나머지를 squash로 변경

# 방법 2: soft reset
git reset --soft HEAD~4
git commit -m "feat: complete user authentication"

# 방법 3: merge --squash
git checkout main
git merge --squash feature/user-auth
git commit -m "feat: add user authentication system"

# 서브모듈 추가
git submodule add https://github.com/org/shared-lib.git libs/shared

# 클론 시 서브모듈 포함
git clone --recurse-submodules https://github.com/org/project.git

# 서브모듈 업데이트
git submodule update --remote --merge

# 모든 서브모듈에 명령 실행
git submodule foreach 'git checkout main && git pull'

# reflog에서 삭제된 브랜치의 마지막 커밋 찾기
git reflog
# abc1234 HEAD@{5}: checkout: moving from deleted-branch to main

# 브랜치 복구
git checkout -b recovered-branch abc1234

# main 브랜치의 특정 파일을 현재 브랜치로 가져오기
git checkout main -- src/config.js

# 특정 커밋의 파일 가져오기
git checkout abc1234 -- src/config.js

# 마지막 커밋의 날짜를 현재 시간으로 변경
GIT_COMMITTER_DATE="$(date)" git commit --amend --date="$(date)"

# 특정 날짜로 변경 (리베이스 중)
GIT_COMMITTER_DATE="2026-03-22T10:00:00" git commit --amend --date="2026-03-22T10:00:00"

# 파일의 각 줄을 누가 마지막으로 수정했는지 확인
git blame src/auth.js

# 특정 줄 범위만 확인
git blame -L 10,20 src/auth.js

# 공백 변경 무시
git blame -w src/auth.js

# 코드 이동도 추적
git blame -M src/auth.js
git blame -C src/auth.js

# 특정 파일의 변경 이력
git log --follow -p -- src/auth.js

# 특정 문자열이 추가/삭제된 커밋 찾기 (pickaxe)
git log -S "API_KEY" --oneline

# 특정 저자의 커밋만
git log --author="John" --oneline --since="2026-01-01"

# 통계 정보 포함
git log --stat --oneline -10

# 커밋 간 diff
git log -p --oneline -3

# 여러 원격 저장소 추가
git remote add upstream https://github.com/original/repo.git
git remote add deploy git@deploy-server:app.git

# upstream 동기화 (포크 프로젝트)
git fetch upstream
git rebase upstream/main

# 원격 브랜치 정리
git remote prune origin
git fetch --prune

# 어노테이티드 태그 생성
git tag -a v2.0.0 -m "Release 2.0.0: new payment system"

# 특정 커밋에 태그
git tag -a v1.5.0 abc1234 -m "Hotfix release"

# 태그 푸시
git push origin v2.0.0
git push origin --tags

# 태그 삭제
git tag -d v2.0.0-beta
git push origin --delete v2.0.0-beta

# .husky/pre-commit
#!/bin/sh
npx lint-staged

# .husky/commit-msg
#!/bin/sh
npx commitlint --edit "$1"

# .husky/pre-push
#!/bin/sh
npm test

# 패치 생성
git diff > my-changes.patch
git format-patch -3  # 최근 3개 커밋을 패치 파일로

# 패치 적용
git apply my-changes.patch
git am *.patch  # format-patch로 생성된 패치 적용

# reflog 확인 (HEAD의 이동 기록)
git reflog

# 실수로 reset --hard 한 경우 복구
git reflog
# abc1234 HEAD@{2}: commit: important work
git reset --hard abc1234

# 실수로 삭제한 stash 복구
git fsck --unreachable | grep commit
git stash apply abc1234

type(scope): description

[optional body]

[optional footer(s)]

feat(api)!: change authentication endpoint

BREAKING CHANGE: /auth/login is now /api/v2/auth/login

# 패키지 설치
npm install -D @commitlint/cli @commitlint/config-conventional husky

# commitlint 설정
echo "module.exports = { extends: ['@commitlint/config-conventional'] };" > commitlint.config.js

# Husky 초기화
npx husky init
echo 'npx commitlint --edit "$1"' > .husky/commit-msg

# conventional-changelog 설치
npm install -D conventional-changelog-cli

# CHANGELOG.md 생성
npx conventional-changelog -p angular -i CHANGELOG.md -s

# package.json에 스크립트 추가

{
  "scripts": {
    "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s",
    "release": "standard-version"
  }
}

npm install -D semantic-release

{
  "release": {
    "branches": ["main"],
    "plugins": [
      "@semantic-release/commit-analyzer",
      "@semantic-release/release-notes-generator",
      "@semantic-release/changelog",
      "@semantic-release/npm",
      "@semantic-release/github",
      "@semantic-release/git"
    ]
  }
}

name: CI Pipeline

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [18, 20, 22]

    steps:
      - uses: actions/checkout@v4

      - name: Use Node.js
        uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
          cache: 'npm'

      - run: npm ci
      - run: npm run lint
      - run: npm test
      - run: npm run build

name: PR Checks

on:
  pull_request:
    types: [opened, synchronize, reopened]

jobs:
  lint-and-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: 'npm'

      - run: npm ci

      - name: Lint
        run: npm run lint

      - name: Type Check
        run: npx tsc --noEmit

      - name: Unit Tests
        run: npm test -- --coverage

      - name: Build
        run: npm run build

      - name: Upload coverage
        uses: codecov/codecov-action@v4
        with:
          file: ./coverage/lcov.info

name: Auto Label

on:
  pull_request:
    types: [opened, edited]

jobs:
  label:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/labeler@v5
        with:
          repo-token: ${{ secrets.GITHUB_TOKEN }}

# .github/labeler.yml
frontend:
  - changed-files:
      - any-glob-to-any-file: 'src/components/**'

backend:
  - changed-files:
      - any-glob-to-any-file: 'src/api/**'

documentation:
  - changed-files:
      - any-glob-to-any-file: 'docs/**'

tests:
  - changed-files:
      - any-glob-to-any-file: '**/*.test.*'

# .github/dependabot.yml
version: 2
updates:
  - package-ecosystem: 'npm'
    directory: '/'
    schedule:
      interval: 'weekly'
      day: 'monday'
    open-pull-requests-limit: 10
    labels:
      - 'dependencies'
    groups:
      dev-dependencies:
        dependency-type: 'development'
      production-dependencies:
        dependency-type: 'production'

  - package-ecosystem: 'github-actions'
    directory: '/'
    schedule:
      interval: 'weekly'

name: Deploy

on:
  push:
    tags:
      - 'v*'

jobs:
  deploy:
    runs-on: ubuntu-latest
    environment: production
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: 20

      - run: npm ci
      - run: npm run build

      - name: Deploy to Production
        run: |
          echo "Deploying version $GITHUB_REF_NAME"
          # 실제 배포 명령어

# Nx 초기화
npx create-nx-workspace@latest my-workspace

# Turborepo 초기화
npx create-turbo@latest

# 프로젝트 구조 예시
my-monorepo/
  apps/
    web/          # Next.js 웹앱
    mobile/       # React Native 앱
    api/          # Express API 서버
  packages/
    ui/           # 공유 UI 컴포넌트
    utils/        # 공유 유틸리티
    config/       # 공유 설정
  turbo.json
  package.json

# .github/CODEOWNERS

# 전체 프로젝트 기본 리뷰어
* @team-lead

# 프론트엔드
/apps/web/        @frontend-team
/packages/ui/     @frontend-team

# 백엔드
/apps/api/        @backend-team
/packages/utils/  @backend-team

# DevOps
/.github/         @devops-team
/docker/          @devops-team
*.yml             @devops-team

{
  "pipeline": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**"]
    },
    "test": {
      "dependsOn": ["build"]
    },
    "lint": {}
  }
}

# 변경된 패키지만 빌드
npx turbo run build --filter=...[HEAD^1]

# 특정 앱만 빌드
npx turbo run build --filter=web

# 의존성 포함 빌드
npx turbo run build --filter=web...

# 최근 1개 커밋만 클론 (CI/CD에서 유용)
git clone --depth 1 https://github.com/org/repo.git

# 나중에 전체 히스토리가 필요하면
git fetch --unshallow

# Blob 없이 클론 (필요할 때 다운로드)
git clone --filter=blob:none https://github.com/org/repo.git

# Tree도 제외 (가장 빠른 클론)
git clone --filter=tree:0 https://github.com/org/repo.git

# sparse checkout 활성화
git sparse-checkout init --cone

# 특정 디렉토리만 체크아웃
git sparse-checkout set apps/web packages/ui

# 디렉토리 추가
git sparse-checkout add apps/api

# 설정 확인
git sparse-checkout list

# Git LFS 설치 및 초기화
git lfs install

# 대용량 파일 추적
git lfs track "*.psd"
git lfs track "*.zip"
git lfs track "assets/videos/*"

# .gitattributes 확인
cat .gitattributes
# *.psd filter=lfs diff=lfs merge=lfs -text

# LFS 상태 확인
git lfs ls-files
git lfs status

# 자동 유지보수 활성화
git maintenance start

# 수동으로 가비지 컬렉션
git gc --aggressive

# 객체 압축 상태 확인
git count-objects -vH

# 불필요한 참조 정리
git remote prune origin
git reflog expire --expire=30.days

# Scalar 설치 (Git 2.38+에 포함)
scalar register

# 또는 새로 클론
scalar clone https://github.com/org/massive-repo.git

# Scalar가 자동으로 설정하는 것들:
# - Partial clone
# - Sparse checkout
# - Background maintenance
# - Filesystem monitor
# - Commit graph

# Claude Code에서 자동 커밋 메시지 생성
claude commit

# GitHub Copilot CLI
gh copilot suggest "write a commit message for these changes"

# aicommits 도구
npm install -g aicommits
aicommits

# GitHub Copilot 자동 리뷰 활성화 (저장소 설정에서)
# Settings > Code review > Copilot code review > Enable

# 변경사항 리뷰 요청
claude "review my staged changes"

# 커밋 메시지 작성
claude "write a conventional commit message for my changes"

# PR 설명 생성
claude "write a PR description for the current branch"

# 머지 충돌 해결
claude "help me resolve the merge conflicts in src/auth.js"

name: Auto PR Description

on:
  pull_request:
    types: [opened]

jobs:
  describe:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Generate PR description
        uses: anthropics/claude-code-action@v1
        with:
          prompt: |
            Analyze the diff of this PR and generate a clear description
            including what changed, why, and any risks.