🌳 Git Branch 완벽 가이드: 협업의 필수 도구 마스터하기

혼자서 코딩할 때는 몰랐지만, 팀 프로젝트를 시작하면서 가장 먼저 부딪히는 벽이 바로 Git Branch입니다. "왜 이렇게 복잡하지?" 하며 머리를 감쌌던 경험, 다들 있으시죠?

오늘은 Git Branch의 핵심 개념부터 실전 활용법까지, 한 번에 정리해드릴게요! 💪

---

🤔 Branch가 왜 필요할까?

상상해보세요. 친구와 함께 레고 집를 만드는데, 한 명은 1층을, 다른 한 명은 2층을 동시에 만들어야 한다면? 각자 따로 만든 후 나중에 합치는 게 훨씬 효율적이겠죠!

Branch는 바로 이런 '독립적인 작업 공간'을 만들어주는 도구입니다.

main 브랜치 ────○────○────○
                     \
feature 브랜치        ○────○

✨ Branch의 핵심 개념

용어	설명
브랜치	독립적인 작업 공간 (코드의 분기점)
기본 브랜치	master(Git) 또는 main(GitHub)
HEAD	현재 작업 중인 브랜치를 가리키는 포인터

---

🛠️ Branch 기본 조작법

1️⃣ 브랜치 현황 파악하기

# 현재 브랜치 목록 확인
git branch

# 결과 예시:
# * main      ← 현재 브랜치 (별표로 표시)
#   feature
#   hotfix

2️⃣ 새로운 브랜치 만들기

# 브랜치 생성
git branch feature-login

# main에서 파생되는 브랜치 명시적으로 생성
git branch feature-login main

3️⃣ 브랜치 삭제하기

# 브랜치 삭제 (-D는 강제 삭제)
git branch -D feature-login

💡 꿀팁: 브랜치 이름은 feature-로그인, fix-버그수정처럼 작업 내용을 명확히 표현하세요!

---

🚀 브랜치 이동: checkout vs switch

Git 2.23 버전부터 checkout을 대체할 새로운 명령어들이 등장했습니다!

기존 방식 (checkout)

# 브랜치 변경
git checkout feature-login

# 브랜치 생성 + 변경
git checkout -b feature-signup

🆕 새로운 방식 (switch) - 추천!

# 브랜치 변경
git switch feature-login

# 브랜치 생성 + 변경
git switch -c feature-signup

왜 switch를 쓸까요?

• checkout은 기능이 너무 많아서 헷갈림
• switch는 브랜치 변경에만 집중
• 더 직관적이고 안전함

---

🔧 파일 복원의 새로운 강자: restore

코딩하다가 "아, 이거 원래대로 돌리고 싶다!" 할 때 사용하는 명령어입니다.

파일 변경사항 취소

# 🆕 새로운 방식 (추천)
git restore README.md

# 기존 방식
git checkout -- README.md

스테이지에서 파일 빼기

# 🆕 새로운 방식 (추천)
git restore --staged README.md

# 기존 방식
git reset HEAD README.md

⚠️ 주의: restore로 지운 내용은 커밋하지 않았다면 복구 불가능합니다!

---

🤝 브랜치 합치기: merge의 마법

여러 브랜치에서 작업한 내용을 하나로 합치는 과정입니다.

# 1. main 브랜치로 이동
git checkout main

# 2. feature 브랜치 내용을 main에 병합
git merge feature-login

# 3. 원격 저장소에 반영
git push origin main

병합 후 브랜치 정리

# 병합이 완료된 브랜치 삭제
git branch -d feature-login

# 원격 브랜치도 삭제
git push origin --delete feature-login

---

💥 충돌(Conflict) 해결하기

가장 무서워하는 상황이지만, 사실 그렇게 어렵지 않아요!

충돌이 발생하는 이유

두 브랜치가 같은 파일의 같은 부분을 다르게 수정했을 때 발생합니다.

충돌 해결 과정

# 충돌 발생 시 파일 내용
<<<<<<< HEAD (현재 브랜치)
hello world
hello binky
=======
hello world         
hello gary
>>>>>>> feature-branch (병합하려는 브랜치)

해결 방법:
1. 원하는 코드만 남기고 <<<<<<<, =======, >>>>>>> 삭제
2. 수정 완료 후 저장
3. git add → git commit → git push

🎨 VSCode에서 충돌 해결하기

VSCode는 충돌 해결을 위한 편리한 UI를 제공합니다:

• Accept Current Change: 현재 브랜치 내용 선택
• Accept Incoming Change: 병합하려는 브랜치 내용 선택
• Accept Both Changes: 둘 다 선택
• Compare Changes: 변경사항 비교

---

🆘 실수했을 때: 브랜치 복구하기

"아! 브랜치를 잘못 삭제했다!" 당황하지 마세요. Git은 복구 방법을 제공합니다.

2단계 복구 과정

1단계: 복구 시점 찾기

# 모든 참조 내역 확인
git reflog

# 결과 예시:
# a1b2c3d HEAD@{0}: branch: deleted branch feature-login
# e4f5g6h HEAD@{1}: commit: add login function

2단계: 브랜치 복구하기

# 커밋 해시값을 이용해 브랜치 복구
git checkout -b feature-login e4f5g6h

---

🎯 실전 팁 & 베스트 프랙티스

💡 브랜치 네이밍 컨벤션

# 기능 개발
feature/user-authentication
feature/payment-system

# 버그 수정
fix/login-error
fix/memory-leak

# 긴급 수정
hotfix/security-patch

🔍 유용한 명령어들

# 모든 브랜치의 커밋 그래프로 보기
git log --all --decorate --oneline --graph

# 원격 브랜치 목록 확인
git branch -r

# 로컬 + 원격 브랜치 모두 보기
git branch -a

⚡ 워크플로우 예시

# 1. 새 기능 개발 시작
git switch -c feature/new-dashboard

# 2. 작업 완료 후 커밋
git add .
git commit -m "feat: add new dashboard"

# 3. 원격에 푸시
git push -u origin feature/new-dashboard

# 4. main으로 병합
git switch main
git merge feature/new-dashboard

# 5. 브랜치 정리
git branch -d feature/new-dashboard
git push origin --delete feature/new-dashboard

---

🎉 마무리

Branch를 마스터하면 협업이 훨씬 수월해집니다. 처음엔 복잡해 보이지만, 몇 번 써보면 금세 익숙해져요!

핵심만 기억하세요:

• 🌱 기능별로 브랜치 나누기
• 🔄 작업 완료 후 merge하기
• 🧹 사용 완료된 브랜치 정리하기
• 💥 충돌 발생 시 차근차근 해결하기

오늘부터 Branch를 적극 활용해서 깔끔한 Git 히스토리를 만들어보세요! 🚀

---

이 글이 도움되셨다면 동료 개발자들과도 공유해주세요! 💝