Skip to main content
워크트리는 하나의 저장소에서 여러 브랜치를 각각 다른 폴더에 동시에 펼쳐 놓는 기능입니다.

워크트리란 무엇인가요?

git worktree 는 하나의 저장소(.git 히스토리는 공유)에 여러 작업 트리를 두고, 각 폴더에 다른 브랜치를 동시에 체크아웃해 둘 수 있게 합니다. 브랜치를 바꿀 때마다 작업 중인 변경을 커밋하거나 stash할 필요가 없습니다.
저장소를 처음 열었을 때의 작업 트리를 기본 워크트리(primary), 추가로 만든 폴더를 연결된(linked) 워크트리 라고 합니다. 커밋 히스토리와 브랜치는 모든 워크트리가 공유하지만, 체크아웃된 브랜치와 작업 중인 변경은 독립적입니다.
같은 브랜치를 두 워크트리가 동시에 체크아웃할 수는 없습니다. 이미 점유된 브랜치로 이동할 때의 처리는 점유 브랜치 & 정리에서 다룹니다.

언제 유용한가요?

코드 리뷰

작업 중인 브랜치를 그대로 둔 채 동료의 브랜치를 별도 폴더에서 빌드·실행해 봅니다.

긴급 핫픽스

stash 없이 새 워크트리에서 main 기반 핫픽스를 진행하고 원래 작업으로 돌아옵니다.

병렬 작업

여러 기능을 각각의 폴더에서 진행합니다. 빌드 산출물이 섞이지 않습니다.

장시간 실행 비교

한 브랜치에서 테스트를 돌리는 동안 다른 워크트리에서 계속 작업합니다.

ParalleLane은 워크트리를 어떻게 다루나요?

  • 사이드바에 직접 표시 — 각 저장소 아래에 워크트리가 나열됩니다. 기본 워크트리는 폴더 체크 아이콘, 연결된 워크트리는 Git 폴더 아이콘으로 구분되고, 행마다 체크아웃된 브랜치와 앞섬/뒤처짐이 표시됩니다. 행을 클릭하면 전환됩니다.
  • 워크트리별 독립 상태 — 커밋 그래프 캐시, 저장소 개요, 워킹 카피 상태를 각각 따로 유지합니다. 자세한 규칙은 워크트리별 상태에서 다룹니다.
  • 상단 브레드크럼 — 연결된 워크트리를 볼 때 프로젝트 ⟩ 워크트리 ⟩ 브랜치 로 현재 위치를 표시합니다.
좌측 사이드바 프로젝트 탭에 한 저장소의 워크트리 다섯 개가 나열되어 있다. 맨 위 기본 워크트리는 폴더 체크 아이콘, 나머지 연결된 워크트리는 Git 폴더 아이콘으로 구분되고, 행마다 체크아웃된 브랜치 이름이 있으며 앞섬/뒤처짐이 있는 행에는 개수가 오른쪽에 붙어 있다

이 그룹에서 다루는 내용

워크트리 생성·전환·삭제

만들고, 전환하고, 안전하게 삭제하는 방법.

워크트리별 상태

상태 표시, 독립 그래프·탭, 사이드바 표기 규칙.

점유 브랜치 & 정리

점유된 브랜치 처리와 무효 워크트리 정리(prune).

체크아웃

브랜치 전환 등 기본 동작.