[Git 명렁어] git branch 및 git checkout 브랜치 관리

Git · Branch Guide

Git Branch & Checkout 완전 정복

브랜치는 Git을 제대로 활용하기 위해 반드시 알아야 하는 핵심 기능입니다. 이 가이드는 GitHub 초보자도 쉽게 이해할 수 있도록 브랜치 생성부터 이동까지 전체 과정을 상세히 설명합니다.

1. 브랜치는 무엇인가?

브랜치는 프로젝트의 여러 작업 흐름을 독립적으로 유지할 수 있게 해주는 Git의 가장 강력한 기능 중 하나입니다.

브랜치를 사용하면:

• 기존 코드에 영향 없이 새로운 기능 개발 가능
• 실험용 코드 작성 가능
• 팀원과 동시에 다양한 기능 개발 가능
• 작업 완료 후 main/master와 merge 가능

2. git branch – 브랜치 확인 & 생성

현재 브랜치 목록 확인

git branch

새 브랜치 생성

git branch feature/login

원격까지 포함한 전체 브랜치 보기

git branch -a

3. git checkout – 브랜치 이동

특정 브랜치로 이동

git checkout feature/login

만약 현재 파일에 저장되지 않은 변경 사항이 있다면 checkout이 막힐 수 있습니다.

4. git checkout -b – 생성 + 이동을 한 번에

브랜치를 만들고 → 바로 이동하는 작업은 너무 자주 쓰입니다. 아래 명령은 이 두 작업을 한 번에 수행합니다.

git checkout -b feature/login

이는 다음과 동일합니다:

git branch feature/login
git checkout feature/login

5. 기능 개발 실전 흐름 예시

예: “로그인 기능” 개발을 위해 새로운 브랜치를 만든다고 가정해봅시다.

1) 작업 브랜치 생성 + 이동

git checkout -b feature/login

2) 작업 후 커밋

git add .
git commit -m "Feat: 로그인 기능 구현"

3) main으로 돌아가기

git checkout main

4) 최신 main 가져오기

git pull origin main

5) 작업중이던 브랜치 merge

git merge feature/login

6. 브랜치 삭제

로컬 브랜치 삭제

git branch -d feature/login

강제 삭제

git branch -D feature/login

원격 브랜치 삭제

git push origin --delete feature/login

7. 브랜치 이동 시 겪는 일반적인 문제

❗ 변경 사항이 남아서 checkout이 안 될 때

git stash
git checkout 다른브랜치
git stash pop

❗ 브랜치를 삭제할 수 없을 때

merge되지 않은 브랜치는 -d로 삭제할 수 없습니다.

git branch -D feature/login

8. 요약

명령	설명
git branch	브랜치 목록 확인 / 생성
git checkout	브랜치 이동
git checkout -b	브랜치 생성 + 이동
git branch -d	로컬 브랜치 삭제
git push origin --delete	원격 브랜치 삭제

브랜치를 자유롭게 만들고 이동할 수 있어야 Git을 제대로 사용할 수 있습니다. git branch와 git checkout의 조합을 이해하면 협업과 기능 개발이 훨씬 쉬워집니다.