👨‍💻 [IT] Git WorkTree 를 GitHub Flow 와 함께 쓰는 패턴은 어떻게 되나요?

"이 포스팅은 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다."

---

👨‍💻 안녕하세요, 윌리 프로젝트의 윌리 입니다.

Git WorkTree 를 GitHub Flow 와 함께 쓰는 패턴은 어떻게 되는지 간략히 알아보았습니다.

---

질문 >

Git WorkTree 를 GitHub Flow 와 함께 쓰는 패턴은 어떻게 되나요?

답변 >

GitHub Flow + git worktree는 실제 현업이나 1인 개발에서도 가장 스트레스 적은 조합 중 하나입니다.

아래는 실전 패턴 위주로 정리했습니다.

---

1️⃣ GitHub Flow 핵심 요약 (전제)

GitHub Flow는 매우 단순합니다.

1. main 은 항상 배포 가능 상태
2. 작업은 모두 main에서 feature 브랜치로 분기
3. 작업 완료 → Pull Request
4. 리뷰 & 테스트
5. main에 merge → 즉시 배포 가능

👉 release / develop 브랜치 없음

---

2️⃣ 기본 디렉터리 구조 패턴

📁 추천 구조

project/
 ├─main/                 ← 항상main 브랜치
 ├─ wt-feature-login/     ← 기능 개발
 ├─ wt-fix-crash/         ← 버그 수정
 └─ wt-review-123/        ← PR 리뷰용

• wt- 접두어를 붙이면 관리가 매우 편해집니다.

---

3️⃣ main worktree는 “기준점”으로 유지

gitclone <https://github.com/user/project.git>
cd project

이 디렉터리는 절대 실험하지 않는 공간입니다.

• 항상 main
• 항상 깨끗한 상태
• 배포/릴리즈/빌드 확인용

---

4️⃣ 기능 개발 패턴 (Feature Flow)

1) 기능용 worktree 생성

git worktree add -b feature/login ../wt-feature-login origin/main

2) 해당 폴더에서 작업

wt-feature-login/
 └─ feature/login 브랜치

• IDE도 이 폴더를 별도로 엽니다
• main은 그대로 유지

3) 커밋 & PR 생성

git push origin feature/login

→ GitHub에서 PR 생성

→ 리뷰 → merge

---

5️⃣ PR 리뷰 전용 worktree 패턴 ⭐

리뷰 요청이 왔을 때 가장 빛나는 부분

git fetch origin
git worktree add ../wt-review-456 pull/456/head

• PR 번호 456
• 브랜치 이름 신경 안 써도 됨
• 리뷰 끝나면 바로 삭제

git worktree remove ../wt-review-456

---

6️⃣ 긴급 버그 수정 (Hotfix)

상황

• feature 작업 중
• 운영 버그 발생

해결

git worktree add -b fix/null-crash ../wt-fix-null origin/main

• 기존 feature 작업 전혀 건드리지 않음
• 수정 후 바로 PR → merge

---

7️⃣ 병렬 작업 패턴 (1인 개발에 특히 좋음)

main/
 ├─ 배포 확인
 ├─ CI 통과 여부 확인

wt-feature-ui/
 ├─ UI 개선 작업

wt-feature-save/
 ├─ 세이브 기능 개발

wt-fix-build/
 ├─ 빌드 오류 수정

👉 브랜치 전환 = 폴더 이동

---

8️⃣ GitHub Actions + worktree 궁합

• main worktree
  • CI 상태 확인
  • 배포 빌드 테스트
• feature worktree
  • 로컬 테스트
  • 실험적 코드

PR merge 전후 상태 비교가 쉬움

---

9️⃣ cleanup 규칙 (중요)

PR merge 후

git branch -d feature/login
git worktree prune

또는

git worktree remove ../wt-feature-login

👉 안 쓰는 worktree는 바로 삭제

---

1️⃣0️⃣ 추천 네이밍 규칙

용도	예시
기능	feature/login
버그	fix/null-pointer
리뷰	wt-review-123
실험	exp-new-ai

---

1️⃣1️⃣ 언제 이 패턴이 특히 좋을까?

✔ GitHub Flow 사용

✔ PR 중심 개발

✔ Unity / Android / iOS / Unreal 같이 빌드 무거운 프로젝트

✔ 1인 개발 or 소규모 팀

👉 질문 주셨던 Unity 2D 1인 개발에도 매우 잘 맞습니다.

---

한 줄 정리

• GitHub Flow + git worktree = 브랜치 전환 없는 병렬 개발 환경

---

---

🎬 유튜브 채널 🎬

위로그@WiLog

🎬 치지직 채널 🎬

위로그 채널 - CHZZK

---