Skip to main content
체크아웃은 작업 트리를 특정 브랜치·태그·커밋으로 전환하는 작업입니다. ParalleLane에서는 커밋 그래프에서 바로 더블클릭해 전환할 수 있고, 커밋되지 않은 변경이 있으면 처리 방법을 모달에서 고릅니다.
브랜치 체크아웃 다이얼로그 — 대상 브랜치와 로컬 변경사항 처리 방법(변경 안 함 / 임시저장 후 복원 / 버리기) 선택

그래프에서 더블클릭 체크아웃

그래프의 행을 더블클릭하면 그 위치로 체크아웃합니다. 무엇을 더블클릭했는지에 따라 대상이 정해집니다.
  • 브랜치 배지 더블클릭 → 그 브랜치로 체크아웃(원격 전용 배지는 DWIM으로 동일 이름 로컬 브랜치 체크아웃).
  • 태그 배지 더블클릭 → 그 태그로 체크아웃(detached HEAD).
  • 커밋 본문 더블클릭 → 우선순위로 대상을 자동 선택합니다. 로컬 main/master → 그 외 로컬 브랜치(현재 HEAD 우선) → 원격 브랜치 → 태그 순이며, 어느 ref도 없으면 그 커밋 SHA로 detached 체크아웃 합니다.
태그나 커밋(SHA)으로 체크아웃하면 저장소가 detached HEAD 상태가 됩니다. 한 번 클릭은 선택(상세 보기)만 하고, 전환은 더블클릭에서만 일어납니다.
그래프에 함께 그려지는 스태시(stash) 노드는 예외입니다. 더블클릭하면 체크아웃이 아니라 그 스태시를 즉시 적용합니다(확인 모달 없음). 삭제까지 고르려면 우클릭 메뉴를 쓰세요 — 스태시를 참고하세요.

체크아웃 모달 (로컬 변경 처리)

작업 트리가 깨끗하면 모달 없이 즉시 전환합니다. 커밋되지 않은 변경이 있으면 체크아웃 다이얼로그가 떠서 로컬 변경사항(Local changes) 처리 방법을 고릅니다.

변경 안 함 (Don't change)

변경을 그대로 두고 전환합니다. 충돌하면 Git이 전환을 막습니다.

임시저장 후 복원 (Stash and reapply)

변경을 stash로 저장하고 전환한 뒤 다시 적용합니다. 기본값 입니다.

버리기 (Discard)

커밋되지 않은 변경을 폐기하고 전환합니다. 되돌릴 수 없습니다.
버리기 는 커밋되지 않은 로컬 변경을 되돌릴 수 없게 폐기합니다. 전환 전에 남길 변경이 없는지 확인하세요.

체크아웃 시 자동 fast-forward pull

업스트림을 추적하는 로컬 브랜치로 체크아웃하면, 전환 직후 백그라운드에서 원격을 fast-forward로 따라잡습니다. 낡은 로컬 상태를 보지 않도록 해 주는 기능입니다.
  • 체크아웃은 즉시 완료되고, pull은 그 뒤에 백그라운드로 실행되어 체감 지연을 늘리지 않습니다.
  • fast-forward가 불가능하거나(브랜치가 갈라짐) 네트워크/인증이 실패하면 브랜치를 건드리지 않고 경고 알림만 띄웁니다. 머지·리베이스·충돌을 만들지 않습니다.
  • 진행 상황은 체크아웃 알림과 이어진 하나의 알림으로 표시됩니다.
이 동작은 기본으로 켜져 있으며, 설정 → ParalleLane → Git체크아웃 시 자동 fast-forward 토글로 끌 수 있습니다. 오프라인이거나 업스트림이 없는 브랜치에서는 아무 것도 하지 않습니다.
이미 체크아웃한 브랜치의 원격 배지(예: 현재가 feature일 때 origin/feature 배지)를 더블클릭하면 전환할 것이 없으므로 체크아웃 대신 같은 fast-forward pull만 실행합니다. 이 경우는 자동 토글과 무관하게 동작합니다.
진짜 머지가 필요한 pull은 이 자동 동작 대신 푸시 · 풀 · 페치의 Pull 다이얼로그를 사용하세요.

다른 워크트리가 쓰는 브랜치

체크아웃하려는 브랜치가 다른 워크트리에 이미 체크아웃돼 있으면 Git은 한 브랜치를 두 워크트리가 동시에 쓰지 못하게 막습니다. 이때 ParalleLane은 빨간 에러 대신 다른 워크트리로 전환(Switch to another worktree) 확인 모달을 띄웁니다. 대상 브랜치(Branch) 와 그 브랜치를 점유한 워크트리(Worktree) 이름을 보여주고, 전환(Switch) 을 누르면 그 워크트리로 옮겨 갑니다. 현재 워크트리는 전혀 건드리지 않습니다 — 체크아웃이 일어나지 않았으므로 Undo에도 기록되지 않습니다.
대상 브랜치가 다른 워크트리에서 이미 사용 중일 때 뜨는 전환 확인 다이얼로그 — 브랜치와 점유 워크트리 이름, 취소·전환 버튼
점유 브랜치 처리와 워크트리 전환에 대한 자세한 내용은 워크트리 고급 활용을 참고하세요.