원격 브랜치를 안전하게 정리하기

언제 사용하나

머지 완료된 브랜치가 쌓여 목록이 지저분할 때 정리할 때.

실행 전 확인

• 삭제할 브랜치가 정말 머지됐는지 확인한다.

명령

# 원격에서 사라진 브랜치의 로컬 추적 참조 정리
git fetch --prune

# 기본 브랜치에 이미 머지된 로컬 브랜치 확인
git branch --merged {{BASE}}

# 로컬 브랜치 삭제(머지된 것만 안전하게: -d)
git branch -d {{BRANCH}}

# 원격 브랜치 삭제(권한·팀 합의 확인 후)
git push origin --delete {{BRANCH}}

placeholder 설명

• {{BASE}} : 기준 브랜치(예: dev)
• {{BRANCH}} : 삭제할 브랜치

입력 예시

git branch -d feature/order-api

기대 결과

불필요한 브랜치가 정리되어 목록이 깔끔해진다.

검증 방법

git branch -a로 남은 브랜치 목록을 확인한다.

주의사항과 흔한 실수

• -D(강제 삭제)는 머지 안 된 작업을 잃을 수 있으니 기본으로 쓰지 않는다.
• 원격 브랜치 삭제는 되돌리기 번거로우니 팀 합의 후 진행한다.

관련 문서

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