[Git] Worktree를 활용한 병렬 작업 환경 구축

2026-02-15 hit count image

Git Worktree를 사용하여 별도의 디렉터리에서 병렬로 작업하는 방법에 대해서 알아봅시다.

git

개요

Git Worktree는 Git의 기본 기능으로, 브랜치와 달리 새로운 디렉터리를 생성하여 작업할 수 있는 환경을 만들어주는 옵션입니다.

현재 작업 중인 브랜치를 유지하면서, 다른 브랜치의 작업을 동시에 진행해야 할 때 유용합니다. 예를 들어, 기능 개발 중에 긴급한 버그 수정이 필요하거나, 코드 리뷰를 위해 다른 브랜치를 확인해야 할 때 stashcommit 없이 바로 별도의 디렉터리에서 작업할 수 있습니다.

Worktree로 별도의 디렉터리 생성

다음 명령어를 사용하면 새로운 브랜치를 생성하면서 별도의 디렉터리에 작업 환경을 구축할 수 있습니다.

git worktree add -b feature/service/add-test ../new-directory
cd ../new-directory
yarn
code .

각 명령어의 역할은 다음과 같습니다.

  • git worktree add -b feature/service/add-test ../worktree: feature/service/add-test라는 새로운 브랜치를 생성하고, ../new-directory 디렉터리에 작업 트리를 생성합니다.
  • cd ../new-directory: 생성된 worktree 디렉터리로 이동합니다.
  • yarn: 의존성 패키지를 설치합니다.
  • code .: VS Code에서 해당 디렉터리를 엽니다.

Worktree의 활용

Worktree로 생성한 별도의 작업 환경에서 생성형 AI를 활용하여 테스트 코드 작성 등의 작업을 진행할 수 있습니다.

Worktree 삭제

작업이 완료되면, 먼저 PR을 생성하고 해당 PR을 merge 합니다.

이후, 다음 절차를 통해 Worktree를 삭제합니다.

  1. 먼저 현재 등록된 Worktree 목록을 확인합니다.
# 원래 레포지토리의 디렉토리 (worktree의 디렉토리가 아님)
git worktree list
  1. 다음 명령어로 Worktree를 삭제합니다.
git worktree remove ../new-directory

완료

이것으로 Git Worktree를 사용하여 별도의 디렉터리에서 병렬로 작업하는 방법에 대해서 알아보았습니다. 현재 작업 중인 브랜치를 그대로 유지하면서 다른 브랜치에서 작업해야 할 때, Worktree를 활용해 보시기 바랍니다. 특히, 생성 AI와 함께 작업할 때, Worktree는 큰 도움이 되므로, 생성 AI와 함께 작업을 하신다면, 꼭 활용해 보시기 바랍니다.

제 블로그가 도움이 되셨나요? 하단의 댓글을 달아주시면 저에게 큰 힘이 됩니다!

앱 홍보

책 홍보

블로그를 운영하면서 좋은 기회가 생겨 책을 출판하게 되었습니다.

아래 링크를 통해 제가 쓴 책을 구매하실 수 있습니다.
많은 분들에게 도움이 되면 좋겠네요.



SHARE
Twitter Facebook RSS