> ## Documentation Index
> Fetch the complete documentation index at: https://docs.parallelane.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 워크트리란?
> 워크트리 개념과 활용
워크트리는 하나의 저장소에서 여러 브랜치를 각각 다른 폴더에 동시에 펼쳐 놓는 기능입니다.
## 워크트리란 무엇인가요?
`git worktree` 는 하나의 저장소(`.git` 히스토리는 공유)에 여러 작업 트리를 두고, 각 폴더에 다른 브랜치를 동시에 체크아웃해 둘 수 있게 합니다.
브랜치를 바꿀 때마다 작업 중인 변경을 커밋하거나 stash할 필요가 없습니다.
저장소를 처음 열었을 때의 작업 트리를 **기본 워크트리**(primary), 추가로 만든 폴더를 **연결된(linked) 워크트리** 라고 합니다.
커밋 히스토리와 브랜치는 모든 워크트리가 공유하지만, 체크아웃된 브랜치와 작업 중인 변경은 독립적입니다.
**같은 브랜치를 두 워크트리가 동시에 체크아웃할 수는 없습니다.** 이미 점유된 브랜치로 이동할 때의 처리는 [점유 브랜치 & 정리](/ko/worktrees/advanced)에서 다룹니다.
## 언제 유용한가요?
작업 중인 브랜치를 그대로 둔 채 동료의 브랜치를 별도 폴더에서 빌드·실행해 봅니다.
stash 없이 새 워크트리에서 `main` 기반 핫픽스를 진행하고 원래 작업으로 돌아옵니다.
여러 기능을 각각의 폴더에서 진행합니다.
빌드 산출물이 섞이지 않습니다.
한 브랜치에서 테스트를 돌리는 동안 다른 워크트리에서 계속 작업합니다.
## ParalleLane은 워크트리를 어떻게 다루나요?
* **사이드바에 직접 표시** — 각 저장소 아래에 워크트리가 나열됩니다.
기본 워크트리는 폴더 체크 아이콘, 연결된 워크트리는 Git 폴더 아이콘으로 구분되고, 행마다 체크아웃된 브랜치와 앞섬/뒤처짐이 표시됩니다.
행을 클릭하면 전환됩니다.
* **워크트리별 독립 상태** — 커밋 그래프 캐시, 저장소 개요, 워킹 카피 상태를 각각 따로 유지합니다.
자세한 규칙은 [워크트리별 상태](/ko/worktrees/status)에서 다룹니다.
* **상단 브레드크럼** — 연결된 워크트리를 볼 때 `프로젝트 ⟩ 워크트리 ⟩ 브랜치` 로 현재 위치를 표시합니다.
## 이 그룹에서 다루는 내용
만들고, 전환하고, 안전하게 삭제하는 방법.
상태 표시, 독립 그래프·탭, 사이드바 표기 규칙.
점유된 브랜치 처리와 무효 워크트리 정리(prune).
브랜치 전환 등 기본 동작.