✍️ 필사 모드: Git 마스터 가이드 — 기초부터 rebase, cherry-pick, bisect, worktree까지

# 객체 타입 확인
git cat-file -t HEAD

# 커밋 객체 내용 보기
git cat-file -p HEAD

# tree 객체 탐색
git ls-tree HEAD

# 세 영역 간 파일 이동 흐름
# Working -> Staging
git add file.txt

# Staging -> Repository
git commit -m "feat: add file"

# Repository -> Working (특정 파일 되돌리기)
git checkout HEAD -- file.txt

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

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

# Detached HEAD 상태 만들기
git checkout HEAD~2

# 저장소 초기화 / 클론
git init
git clone https://github.com/user/repo.git

# 변경 사항 확인
git status
git diff                    # unstaged 변경
git diff --staged           # staged 변경
git diff HEAD               # 전체 변경

# 스테이징 & 커밋
git add -p                  # 대화형 부분 스테이징
git commit -m "feat: login" # 커밋
git commit --amend          # 마지막 커밋 수정

# 원격 동기화
git fetch origin            # 원격 변경만 가져오기
git pull --rebase origin main  # fetch + rebase
git push origin feature/login  # 푸시

# 브랜치 생성 & 이동
git branch feature/auth
git checkout -b feature/auth  # 생성 + 이동
git switch -c feature/auth    # Git 2.23+ 추천

# 브랜치 목록
git branch -a               # 로컬 + 원격
git branch --merged          # 병합 완료된 브랜치
git branch -d feature/old    # 안전 삭제
git branch -D feature/old    # 강제 삭제

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

# 현재 변경 사항 저장
git stash
git stash push -m "WIP: login form"

# stash 목록 확인
git stash list

# 복원
git stash pop               # 꺼내면서 삭제
git stash apply stash@{0}  # 꺼내되 유지

# 특정 파일만 stash
git stash push -m "partial" -- src/auth.ts

# stash를 브랜치로 변환
git stash branch new-branch stash@{0}

# feature 브랜치를 main에 merge
git checkout main
git merge feature/auth

# feature 브랜치에서 main의 최신 변경을 가져오기
git checkout feature/auth
git rebase main

# 최근 5개 커밋 정리
git rebase -i HEAD~5

# 실제 사용 예시: PR 전에 커밋 정리
# 에디터에서 아래처럼 수정
# pick abc1234 feat: add login page
# squash def5678 fix: typo in login
# squash ghi9012 style: adjust padding
# -> 3개 커밋이 1개로 합쳐짐

# 특정 커밋 가져오기
git cherry-pick abc1234

# 여러 커밋 한번에
git cherry-pick abc1234 def5678

# 범위로 가져오기 (abc는 미포함, def는 포함)
git cherry-pick abc1234..def5678

# 커밋하지 않고 변경만 적용
git cherry-pick --no-commit abc1234

# bisect 시작
git bisect start

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

# 정상이었던 커밋을 good으로 표시
git bisect good v2.0.0

# Git이 중간 커밋을 체크아웃 -> 테스트 -> 판별
git bisect good  # 또는 git bisect bad

# 원인 커밋을 찾으면 리셋
git bisect reset

# 테스트 스크립트로 자동 bisect
git bisect start HEAD v2.0.0
git bisect run npm test

# 새 worktree 생성
git worktree add ../project-hotfix hotfix/critical-bug

# worktree 목록 확인
git worktree list

# worktree 제거
git worktree remove ../project-hotfix

# 새 브랜치를 만들면서 worktree 생성
git worktree add -b feature/new-ui ../project-ui

# reflog 확인
git reflog

# 실수로 reset --hard 했을 때 복구
git reflog
# HEAD@{2}: commit: important feature 를 찾으면
git reset --hard HEAD@{2}

# 삭제된 브랜치 복구
git reflog
git checkout -b recovered-branch HEAD@{5}

# 특정 기간 내 기록
git reflog --since="2 days ago"

[alias]
    # 상태 & 로그
    st = status -sb
    lg = log --oneline --graph --decorate --all
    last = log -1 HEAD --stat

    # 브랜치
    co = checkout
    sw = switch
    br = branch -vv
    brd = branch -d

    # 커밋
    cm = commit -m
    ca = commit --amend --no-edit
    undo = reset HEAD~1 --mixed

    # diff
    df = diff --stat
    dfc = diff --cached

    # stash
    sl = stash list
    sp = stash pop
    ss = stash push -m

    # 정리
    cleanup = "!git branch --merged | grep -v '\\*\\|main\\|develop' | xargs -n 1 git branch -d"

[core]
    editor = code --wait
    autocrlf = input          # macOS/Linux
    ignorecase = false
    pager = delta              # delta pager 사용

[pull]
    rebase = true              # pull 시 항상 rebase

[push]
    default = current          # 현재 브랜치만 push
    autoSetupRemote = true     # push 시 자동 upstream 설정

[init]
    defaultBranch = main

[diff]
    tool = vscode
    colorMoved = default

[merge]
    conflictstyle = diff3      # 3-way 충돌 표시
    tool = vscode

[rerere]
    enabled = true             # 충돌 해결 기억하기

# 설치
brew install git-delta

# .gitconfig에 추가

[core]
    pager = delta

[interactive]
    diffFilter = delta --color-only

[delta]
    navigate = true
    line-numbers = true
    side-by-side = true

## 변경 사항
- 무엇을 왜 변경했는지

## 테스트
- [ ] 단위 테스트 추가/수정
- [ ] 로컬에서 동작 확인
- [ ] 엣지 케이스 검증

## 스크린샷 (UI 변경 시)

## 관련 이슈
- closes #123

# .github/CODEOWNERS

# 전체 코드베이스
* @team-lead

# 프론트엔드
/src/components/ @frontend-team
/src/pages/ @frontend-team

# 백엔드 API
/src/api/ @backend-team

# 인프라
/terraform/ @devops-team
/k8s/ @devops-team

# 보안 민감 파일
/src/auth/ @security-team @team-lead

type(scope): description

body (선택)

footer (선택)

# 예시
git commit -m "feat(auth): add Google OAuth login"
git commit -m "fix(api): handle null response from payment gateway"
git commit -m "docs(readme): update installation instructions"

# Breaking Change
git commit -m "feat(api)!: change response format to JSON:API"

git commit -m ":sparkles: add user profile page"
git commit -m ":bug: fix login redirect loop"
git commit -m ":recycle: refactor database connection pool"
git commit -m ":white_check_mark: add unit tests for auth module"

# 설치
npm install -D @commitlint/cli @commitlint/config-conventional

# commitlint.config.js

module.exports = {
  extends: ['@commitlint/config-conventional'],
  rules: {
    'type-enum': [2, 'always', [
      'feat', 'fix', 'docs', 'style',
      'refactor', 'perf', 'test', 'chore', 'ci'
    ]],
    'subject-max-length': [2, 'always', 72],
  },
};

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

# 필요한 디렉토리만 지정
git sparse-checkout set packages/frontend packages/shared

# 디렉토리 추가
git sparse-checkout add packages/backend

# 설정 확인
git sparse-checkout list

# 전체 복원
git sparse-checkout disable

# 외부 저장소 추가
git subtree add --prefix=libs/shared-utils \
  https://github.com/org/shared-utils.git main --squash

# 변경 사항 가져오기
git subtree pull --prefix=libs/shared-utils \
  https://github.com/org/shared-utils.git main --squash

# 변경 사항 내보내기
git subtree push --prefix=libs/shared-utils \
  https://github.com/org/shared-utils.git main

# Nx: 영향받는 프로젝트만 테스트
npx nx affected --target=test --base=main --head=HEAD

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

# GitHub Actions에서 변경 감지
# CI에서 main과 비교하여 변경된 패키지만 처리

# 1. reflog에서 원래 커밋 찾기
git reflog show origin/main

# 2. 원래 커밋으로 복구
git push origin HEAD@{1}:main --force

# 3. 다른 팀원에게 알리기
# "main 브랜치가 복구되었습니다. git pull --rebase를 실행해주세요"

# main 브랜치 force push 차단 (GitHub Settings)
# Settings -> Branches -> Branch protection rules
# "Restrict force pushes" 활성화

# BFG 설치
brew install bfg

# 특정 파일 히스토리에서 완전 제거
bfg --delete-files secrets.env

# 특정 텍스트 치환
bfg --replace-text passwords.txt

# 정리
git reflog expire --expire=now --all
git gc --prune=now --aggressive

# 강제 푸시
git push --force

# Git LFS 설치 & 초기화
brew install git-lfs
git lfs install

# 추적할 파일 패턴 지정
git lfs track "*.psd"
git lfs track "*.zip"
git lfs track "assets/videos/*"

# .gitattributes가 자동 생성됨 - 커밋 필요
git add .gitattributes
git commit -m "chore: configure Git LFS tracking"

# LFS 파일 목록 확인
git lfs ls-files

# 이미 커밋된 대용량 파일을 LFS로 마이그레이션
git lfs migrate import --include="*.psd" --everything

# merge 커밋 자체를 revert
git revert -m 1 MERGE_COMMIT_SHA

# -m 1: 첫 번째 부모(main)를 기준으로 되돌림
# -m 2: 두 번째 부모(feature)를 기준으로 되돌림

# 1. reflog 확인 (90일 이내)
git reflog

# 2. dangling 객체에서 복구
git fsck --lost-found

# 3. 최악의 경우: 팀원의 로컬 저장소에서 복구
# 팀원에게 push를 요청하거나, bundle로 받기
git bundle create backup.bundle --all