작업 브랜치를 안전하게 생성·전환하기

언제 사용하나

새 작업을 시작할 때 최신 기준에서 깨끗한 브랜치를 만들 때.

실행 전 확인

• git status로 커밋 안 된 변경이 없는지 확인한다.
• 기준 브랜치(예: dev)가 최신인지 확인한다.

명령

# 1) 기준 브랜치 최신화
git switch {{BASE}}
git pull --ff-only origin {{BASE}}

# 2) 새 작업 브랜치 생성 + 전환
git switch -c {{BRANCH}}

# 3) 확인
git status
git branch --show-current

placeholder 설명

• {{BASE}} : 기준 브랜치 (예: dev)
• {{BRANCH}} : 새 브랜치 이름 (예: feature/login)

입력 예시

{{BASE}} = dev, {{BRANCH}} = feature/order-api

기대 결과

현재 브랜치가 새 작업 브랜치로 바뀌고 작업 트리가 깨끗하다.

검증 방법

git branch --show-current가 새 브랜치를 가리키는지 확인한다.

주의사항과 흔한 실수

• 커밋 안 된 변경이 있으면 먼저 커밋하거나 git stash로 보관한다.
• pull --ff-only는 예기치 않은 머지 커밋을 막아준다.

관련 문서

• git switch: https://git-scm.com/docs/git-switch