Skip to main content
모든 동작은 좌측 사이드바에서 시작됩니다.

새 워크트리 만들기

저장소의 기본 브랜치에서 새 브랜치를 만들고, 그 브랜치를 체크아웃한 폴더를 한 번에 생성합니다.
1

+ 버튼 누르기

사이드바에서 저장소 행에 마우스를 올리면 나타나는 + 버튼(워크트리 추가)을 클릭합니다.
워크트리 생성 다이얼로그. 새 브랜치 이름 입력란, 자동으로 채워진 워크트리 경로와 찾아보기 버튼, 그 아래 기준 브랜치 표시가 보인다
2

새 브랜치 이름 입력

만들 브랜치 이름을 입력합니다. 다이얼로그 아래에 기준 브랜치가 기준: main 처럼 표시되며, 기준은 origin/HEAD → 로컬 main → 로컬 master 순으로 해석됩니다.
3

워크트리 경로 확인

경로는 <저장소부모>/<저장소이름>-<브랜치> 형태로 자동 제안되고, 브랜치 이름의 /- 로 바뀝니다. 직접 편집하기 전까지는 브랜치 이름에 따라 갱신되며, 찾아보기… 로 부모 폴더를 바꿀 수 있습니다.
4

생성

생성 을 누르면 새 워크트리가 만들어지고 자동으로 선택됩니다.
기준 브랜치를 찾지 못하면(main/master/origin/HEAD 모두 없음) 생성이 막힙니다. 경로가 비어 있지 않거나 브랜치 이름이 중복이나 무효이면 Git이 거부하고 실패 토스트에 사유가 표시됩니다.

워크트리 전환하기

사이드바에서 워크트리 행을 클릭하면 전환됩니다. 실제로 다른 워크트리로 바뀔 때 열려 있던 diff 탭은 모두 닫히고 히스토리(History) 탭 하나로 초기화됩니다.
다른 워크트리로 전환한 직후의 화면. 탭 줄에 히스토리 탭 하나만 남아 있고 사이드바에서는 새로 선택된 워크트리 행이 강조되어 있다
그래프, 저장소 개요, 워킹 카피 상태는 워크트리별로 캐시됩니다. 오갈 때 빠르게 다시 나타납니다. 워크트리별 상태를 참고하세요.

워크트리 삭제하기

1

삭제 버튼 열기

연결된 워크트리 행에 마우스를 올리면 앞섬/뒤처짐 카운터 자리에 휴지통 아이콘이 나타납니다.
2

옵션 확인

다이얼로그에 두 개의 토글이 있습니다(둘 다 기본 꺼짐).
  • 브랜치도 함께 삭제 는 체크아웃돼 있던 브랜치까지 지웁니다. 강제 삭제가 꺼져 있으면 병합되지 않은 브랜치는 삭제가 거부됩니다. 분리된 HEAD 워크트리에는 나타나지 않습니다.
  • 강제 삭제 는 커밋하지 않은 변경이 있는 워크트리도 제거합니다. 브랜치도 함께 삭제 를 같이 켜면 라벨이 강제 삭제 (커밋되지 않은 변경 폐기, Merge되지 않은 브랜치도 삭제) 로 바뀌고, 병합되지 않은 브랜치까지 지웁니다.
워크트리 삭제 확인 다이얼로그. 삭제할 워크트리 경로 안내 아래에 브랜치도 함께 삭제 토글과 강제 삭제 토글이 차례로 놓여 있고 둘 다 꺼져 있다
3

삭제 실행

삭제 를 누릅니다. 삭제한 워크트리가 선택 중이었다면 선택은 기본 워크트리로 이동합니다.
기본 워크트리에는 삭제 버튼이 없습니다.강제 삭제를 켜면 그 폴더의 커밋하지 않은 변경사항이 사라집니다. 브랜치도 함께 삭제 까지 켜져 있으면 병합되지 않은 커밋도 함께 사라집니다.
워크트리는 지워졌지만 브랜치 삭제만 실패한 경우에는 경고 토스트로 부분 실패를 알려 줍니다.

잠긴 워크트리 삭제 실패와 재시도

삭제 실패 시 위험은 한 단계씩만 높아집니다.
  1. 강제 삭제가 꺼진 상태에서 실패 하면 토스트에 액션 버튼이 붙지 않습니다. 원인(커밋되지 않은 변경 또는 잠금)이 안내되며, 다음 단계로 가려면 다이얼로그를 다시 열어 강제 삭제 토글을 직접 켜야 합니다.
  2. 강제 삭제가 잠금에 막히면 이때만 토스트에 잠금 무시하고 삭제 버튼이 나타납니다. Git의 원본 에러 메시지에 잠금 사유가 들어 있어 누가 잠갔는지 확인할 수 있습니다. 잠금이 아닌 이유로 실패했다면 버튼은 나타나지 않습니다.
  3. 잠금 무시도 실패 하면 더는 재시도 버튼이 붙지 않습니다. 에러 메시지를 보고 직접 해결해야 합니다.
워크트리 잠금은 다른 도구나 세션이 그 워크트리를 점유하는 동안 걸어 두는 보호 장치입니다. 잠금 무시하고 삭제 를 누르기 전에 에러 메시지의 잠금 사유를 읽어 보세요. 살아 있는 작업 공간을 날려 버릴 수 있습니다.