git worktree로 브랜치 전환 없이 여러 브랜치 동시 작업하기

문제

feature 브랜치에서 작업 중인데 갑자기 핫픽스 요청이 들어왔다. git stash 하고 git checkout main 하고 핫픽스 브랜치 만들고… 끝나면 다시 원래 브랜치로 돌아와서 git stash pop. 이 과정이 하루에 몇 번씩 반복되면 진짜 짜증난다.

해결

git worktree를 쓰면 하나의 레포에서 여러 브랜치를 별도 디렉토리에 동시에 열 수 있다.

# main 브랜치를 ../project-main 디렉토리에 열기
git worktree add ../project-main main

# 새 브랜치를 만들면서 worktree 생성
git worktree add ../project-hotfix -b hotfix/login-bug

# 기존 브랜치를 열기
git worktree add ../project-review feature/api-v2

이제 각 디렉토리에서 독립적으로 작업하면 된다. 브랜치 전환이 필요 없다.

# 에디터에서 여러 창으로 동시 작업
code ../project-main      # main 브랜치
code ../project-hotfix    # 핫픽스 브랜치
code .                    # 현재 feature 브랜치

worktree 목록 확인과 정리도 간단하다.

# 현재 worktree 목록
git worktree list
# /home/user/project              abc1234 [feature/auth]
# /home/user/project-main         def5678 [main]
# /home/user/project-hotfix       ghi9012 [hotfix/login-bug]

# 작업 끝난 worktree 삭제
git worktree remove ../project-hotfix

# 이미 디렉토리를 수동 삭제한 경우
git worktree prune

.git 데이터를 공유하기 때문에 git clone보다 디스크를 훨씬 적게 쓴다. 커밋 히스토리도 당연히 공유된다.

핵심 포인트

git worktree add <경로> <브랜치>로 브랜치를 별도 디렉토리에 열 수 있다
브랜치 전환(checkout) 없이 여러 브랜치를 동시에 작업 가능
.git 데이터를 공유하므로 clone보다 가볍다
작업 끝나면 git worktree remove로 정리
같은 브랜치를 두 개의 worktree에서 동시에 열 수는 없다