2026년 개발자를 위한 Git 완벽 가이드: 초보자부터 고수까지 필수 명령어 총정리 🚀

# 브랜치 목록
git branch                          # 로컬 브랜치
git branch -r                       # 원격 브랜치
git branch -a                       # 모든 브랜치
git branch -vv                      # upstream 정보와 함께

# 브랜치 생성
git branch feature-login            # 생성만
git checkout -b feature-login       # 생성 + 전환 (구문법)
git switch -c feature-login         # 생성 + 전환 (신문법, Git 2.23+)

# 브랜치 전환
git checkout main                   # 구문법
git switch main                     # 신문법 (더 명확함)

# 브랜치 삭제
git branch -d feature-login         # 병합된 브랜치 삭제
git branch -D feature-login         # 강제 삭제 (병합 여부 무시)

# 브랜치 이름 변경
git branch -m old-name new-name

# 기본 merge (fast-forward 가능하면 수행)
git merge feature-branch

# non-fast-forward 강제 (merge commit 생성)
git merge --no-ff feature-branch

# merge 취소
git merge --abort

# 특정 전략으로 merge
git merge -X ours feature-branch    # conflict 시 현재 브랜치 우선
git merge -X theirs feature-branch  # conflict 시 대상 브랜치 우선

# 현재 브랜치를 main 위로 rebase
git rebase main

# interactive rebase (강력함!)
git rebase -i HEAD~5

# rebase 중 conflict 해결 후 계속
git rebase --continue

# rebase 중단 (원래 상태로 복구)
git rebase --abort

# 특정 커밋까지 rebase
git rebase --onto newbase oldbase branch

# 현재 변경사항 stash
git stash
git stash push -m "WIP: 로그인 기능 구현 중"

# stash 목록 확인
git stash list
# stash@{0}: On main: WIP: 로그인 기능 구현 중
# stash@{1}: On feature-branch: 임시 수정사항

# stash 적용 (목록에서 제거하지 않음)
git stash apply
git stash apply stash@{1}

# stash 적용 및 제거 (pop)
git stash pop
git stash pop stash@{0}

# 특정 파일만 stash
git stash push -m "부분 stash" path/to/file.txt

# untracked 파일도 포함
git stash push -u -m "untracked 포함"
git stash push --all  # ignored 파일까지 포함

# stash에서 특정 파일만 꺼내기
git checkout stash@{0} -- filename.txt

# stash 삭제
git stash drop stash@{1}

# 모든 stash 삭제
git stash clear

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

# 단일 커밋 cherry-pick
git cherry-pick abc1234

# 여러 커밋 cherry-pick
git cherry-pick abc1234 def5678

# 커밋 범위 cherry-pick (older..newer)
git cherry-pick abc1234^..def5678

# merge commit cherry-pick
git cherry-pick -m 1 abc1234

# 커밋 내용만 적용 (커밋 생성 없이)
git cherry-pick -n abc1234

# cherry-pick 중 conflict 발생 시
git cherry-pick --continue
git cherry-pick --abort
git cherry-pick --skip

# reflog 확인
git reflog
git reflog --date=relative  # 상대 시간으로 표시

# 특정 시점으로 복구
git reset --hard HEAD@{2}
git reset --hard abc1234

# 삭제된 브랜치 복구
git reflog | grep "checkout: moving from"
git branch recovered-branch HEAD@{5}

# ORIG_HEAD 활용 (마지막 위험한 작업 전)
git reset --hard ORIG_HEAD

# 특정 브랜치의 reflog
git reflog show feature-branch

# unreachable 객체 찾기
git fsck --unreachable --no-reflogs | grep commit

#!/bin/bash
# .git/hooks/pre-commit

echo "🔍 Pre-commit checks running..."

# Staged 파일 목록
STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(js|jsx|ts|tsx)$')

if [ -n "$STAGED_FILES" ]; then
    echo "Running ESLint..."
    npx eslint $STAGED_FILES --fix
    
    if [ $? -ne 0 ]; then
        echo "❌ ESLint failed. Commit aborted."
        exit 1
    fi
    
    # 수정된 파일 다시 stage
    echo "$STAGED_FILES" | xargs git add
fi

# 디버그 코드 검사
if git diff --cached | grep -E "console\.log|debugger|TODO|FIXME"; then
    echo "⚠️ Warning: Debug code or TODOs found in staged changes"
    # exit 1  # 강제 차단하려면 주석 해제
fi

echo "✅ Pre-commit checks passed!"
exit 0

#!/bin/bash
# .git/hooks/commit-msg

COMMIT_MSG_FILE=$1
COMMIT_MSG=$(cat "$COMMIT_MSG_FILE")

# Conventional Commits 패턴 검사
PATTERN="^(feat|fix|docs|style|refactor|test|chore|ci|build|perf)(\(.+\))?: .{1,100}"

if ! echo "$COMMIT_MSG" | grep -qE "$PATTERN"; then
    echo "❌ Invalid commit message format!"
    echo ""
    echo "Expected format: (): "
    echo ""
    echo "Types: feat, fix, docs, style, refactor, test, chore, ci, build, perf"
    echo "Example: feat(auth): add JWT token validation"
    echo ""
    exit 1
fi

echo "✅ Commit message format valid!"
exit 0

# 새 worktree 생성 (브랜치 자동 생성)
git worktree add ../project-feature feature-branch

# 기존 브랜치를 worktree로
git worktree add ../project-hotfix hotfix-branch

# worktree 목록
git worktree list

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

# 정리되지 않은 worktree 제거
git worktree prune

# detached HEAD로 worktree 생성
git worktree add --detach ../project-temp

# main worktree로 이동
cd $(git rev-parse --show-toplevel)

# Sparse checkout 활성화
git sparse-checkout init

# 포함할 디렉토리 설정
git sparse-checkout set frontend/app
git sparse-checkout set frontend/app backend/api

# 여러 패턴 추가
git sparse-checkout add shared/utils
git sparse-checkout add docs/

# 현재 설정 확인
git sparse-checkout list

# 비활성화 (전체 체크아웃)
git sparse-checkout disable

# cone mode (더 빠른 성능)
git sparse-checkout init --cone
git sparse-checkout set frontend backend

# macOS
brew install git-lfs
git lfs install

# Ubuntu/Debian
curl -s https://packagecloud.io/install/repositories/github/git-lfs/script.deb.sh | sudo bash
sudo apt-get install git-lfs
git lfs install

# Windows
winget install GitHub.GitLFS
git lfs install

# 저장소별 설정
git lfs install --local

# 파일 패턴 추적
git lfs track "*.psd"
git lfs track "*.zip"
git lfs track "*.mp4"
git lfs track "assets/videos/**"
git lfs track "data/*.csv"

# .gitattributes 자동 생성됨
cat .gitattributes
# *.psd filter=lfs diff=lfs merge=lfs -text

# .gitattributes 반드시 커밋
git add .gitattributes
git commit -m "Configure Git LFS"

# 대용량 파일 추가
git add design/mockup.psd
git commit -m "Add mockup design"
git push

# SSH 키 생성 (Ed25519 권장)
ssh-keygen -t ed25519 -C "your@email.com" -f ~/.ssh/git_signing_key

# Git 설정
git config --global gpg.format ssh
git config --global user.signingkey ~/.ssh/git_signing_key.pub
git config --global commit.gpgsign true  # 모든 커밋 자동 서명

# 또는 특정 저장소만
git config commit.gpgsign true

# allowed_signers 파일 설정 (서명 검증용)
echo "$(git config user.email) namespaces=\"git\" $(cat ~/.ssh/git_signing_key.pub)" > ~/.ssh/allowed_signers
git config --global gpg.ssh.allowedSignersFile ~/.ssh/allowed_signers

# ~/.gitconfig
[alias]
    # 기본 단축
    st = status
    co = checkout
    sw = switch
    br = branch
    ci = commit
    cm = commit -m
    
    # 강력한 단축
    amend = commit --amend --no-edit
    unstage = restore --staged
    last = log -1 HEAD
    visual = !gitk
    
    # 로그 예쁘게 보기
    lg = log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit
    lol = log --graph --decorate --oneline --all
    
    # add + commit + push 한번에
    acp = "!f() { git add -A && git commit -m \"$1\" && git push; }; f"
    amod = "!f() { git add -u && git commit -m \"$1\" && git push; }; f"
    
    # 안전한 업데이트
    up = "!git fetch --prune && git rebase origin/$(git rev-parse --abbrev-ref HEAD)"
    sync = "!git fetch --all --prune"
    
    # 위험하지만 유용한 것들
    nuke = reset --hard
    undo = reset --soft HEAD~1
    
    # stash 단축
    ss = stash
    sp = stash pop
    sl = stash list
    
    # 현재 브랜치 관련
    current = rev-parse --abbrev-ref HEAD
    upstream = rev-parse --abbrev-ref --symbolic-full-name @{u}

# 상황: feature-A 브랜치에서 작업해야 했는데 main에 커밋함

# 1. 커밋을 임시 저장
git reset --soft HEAD~1

# 2. 올바른 브랜치로 이동 (또는 생성)
git switch -c feature-A

# 3. 커밋 재생성
git commit -m "feat: A 기능 구현"

# 또는 cherry-pick 사용
git switch -c feature-A
git cherry-pick main  # main의 마지막 커밋
git switch main
git reset --hard HEAD~1  # main의 커밋 제거

# 방법 1: 마지막 커밋만 수정 (아직 push 안 한 경우)
git reset --soft HEAD~1
# 파일 수정 후
git add .
git commit -m "fixed: remove sensitive data"

# 방법 2: 히스토리 전체 재작성 (이미 push한 경우 - 주의!)
git filter-repo --path config/secrets.json --invert-paths
# 또는
git filter-branch --force --index-filter \
  "git rm --cached --ignore-unmatch config/secrets.json" \
  --prune-empty --tag-name-filter cat -- --all

# 방법 3: BFG Repo-Cleaner (대형 저장소용)
bfg --delete-files secrets.json
git reflog expire --expire=now --all
git gc --prune=now --aggressive

# 1. Conflict 발생 확인
git status
# Unmerged paths: both modified: src/app.js

# 2. Conflict 표시 확인
cat src/app.js
# <<<<<<< HEAD
# 내 코드
# =======
# 상대방 코드
# >>>>>>> feature-branch

# 3. 수동으로 수정 또는 도구 사용
git mergetool  # vimdiff, vscode 등 설정된 도구 실행

# 4. 해결 후 표시
git add src/app.js

# 5. 병합 완료
git commit  # 자동으로 merge commit 생성

# 또는 rebase 중이면
git rebase --continue

# 병합 취소
git merge --abort
git rebase --abort

# 상황: 특정 커밋을 checkout해서 HEAD가 분리됨
# HEAD is now at abc1234...

# 변경사항이 없는 경우: 그냥 브랜치로 돌아가기
git switch main

# 변경사항이 있는 경우
# 방법 1: 새 브랜치 생성 (권장)
git switch -c new-branch-name

# 방법 2: 기존 브랜치에 합치기
git switch main
git merge $(git rev-parse HEAD)
git branch -d temp-branch