git worktree 병렬 개발 가이드: 브랜치별 작업 디렉터리 분리로 생산성 높이기

git worktree 병렬 개발 가이드: 브랜치별 작업 디렉터리 분리로 생산성 높이기

git worktree는 하나의 저장소에서 여러 브랜치를 각기 다른 폴더로 동시에 다룰 수 있게 해준다. 컨텍스트 전환이 잦은 팀에 매우 유용하다. 초보~중급 개발자가 바로 적용할 수 있도록 명령어 흐름, 옵션 선택 기준, 복구 절차를 실무 중심으로 설명한다.

브랜치 작업 분리 개념도 (출처: Pro Git, git-scm.com)

git worktree 기본 사용 패턴

git worktree add ../repo-hotfix hotfix/payment-timeout
git worktree list
git worktree remove ../repo-hotfix

자주 쓰는 옵션 3~6개

항목	의미	언제 쓰는지(실무 상황)
add	새 워크트리 생성	핫픽스와 기능 개발을 병렬로 진행할 때
list	워크트리 목록 확인	현재 연결된 경로와 브랜치를 점검할 때
remove	워크트리 제거	종료된 작업 공간을 정리할 때
prune	끊어진 메타데이터 정리	오래된 워크트리 참조를 정리할 때

실무 적용 순서

1) 실행 전 상태 확인

git status와 git log로 현재 위치를 확인한다. 특히 원격 공유 브랜치인지, 로컬 전용 브랜치인지 먼저 판단해야 안전하다.

2) 목적에 맞는 옵션 선택

동일 명령어라도 옵션에 따라 이력 보존, 충돌 위험, 협업 영향이 달라진다. 팀 정책과 배포 단계에 맞춰 옵션을 고른다.

3) 실행 후 검증

명령 실행 뒤에는 status, diff, 테스트를 통해 결과를 검증한다. 필요하면 즉시 복구 명령(reflog, revert, stash)을 연계한다.

문제 상황 1개

상황: 브랜치 전환을 반복하다 테스트/빌드 환경이 계속 꼬인다.
원인: 하나의 작업 디렉터리에서 서로 다른 작업 컨텍스트를 섞었다.
해결: 기능별 worktree를 분리해 독립 환경으로 운영한다.
예방 팁: 긴급 수정 브랜치는 전용 worktree를 기본 정책으로 둔다.

참고/출처

공식 문서: git-worktree manual
공식 문서: Git glossary (working tree)
신뢰 자료: Atlassian - git worktree