git branch 운영 전략: 생성·이름변경·삭제 규칙으로 협업 브랜치 관리하기

git branch 운영 전략: 생성·이름변경·삭제 규칙으로 협업 브랜치 관리하기

git branch는 협업의 구조를 결정한다. 브랜치 생성과 정리 기준을 문서화하면 충돌 빈도와 릴리스 리스크를 동시에 낮출 수 있다. 초보~중급 개발자가 바로 적용할 수 있도록 명령어 흐름, 옵션 선택 기준, 복구 절차를 실무 중심으로 설명한다.

브랜치 흐름 예시 (출처: Pro Git, git-scm.com)

git branch 기본 사용 패턴

git branch -vv
git branch -m feature/login-oauth feature/auth-oauth
git branch -d feature/auth-oauth

자주 쓰는 옵션 3~6개

항목	의미	언제 쓰는지(실무 상황)
-a	로컬/원격 브랜치 모두 조회	전체 상태를 점검할 때
-vv	추적 대상과 최근 커밋 표시	정리 대상 브랜치를 식별할 때
-m	브랜치 이름 변경	작업 범위 변경 시 네이밍을 맞출 때
-d	병합 완료 브랜치 안전 삭제	릴리스 후 feature 브랜치 정리
-D	병합 여부와 무관하게 강제 삭제	실험 브랜치를 즉시 폐기할 때

실무 적용 순서

1) 실행 전 상태 확인

git status와 git log로 현재 위치를 확인한다. 특히 원격 공유 브랜치인지, 로컬 전용 브랜치인지 먼저 판단해야 안전하다.

2) 목적에 맞는 옵션 선택

동일 명령어라도 옵션에 따라 이력 보존, 충돌 위험, 협업 영향이 달라진다. 팀 정책과 배포 단계에 맞춰 옵션을 고른다.

3) 실행 후 검증

명령 실행 뒤에는 status, diff, 테스트를 통해 결과를 검증한다. 필요하면 즉시 복구 명령(reflog, revert, stash)을 연계한다.

문제 상황 1개

상황: 오래된 브랜치가 누적돼 활성 브랜치 판단이 어렵다.
원인: 브랜치 만료 규칙과 책임자가 정의되지 않았다.
해결: -vv 기준으로 마지막 업데이트가 오래된 브랜치를 주기적으로 정리한다.
예방 팁: feat/, fix/, hotfix/ 같은 네이밍 규칙과 삭제 주기를 팀 규칙으로 고정한다.

참고/출처

공식 문서: git-branch manual
공식 문서: Pro Git - Branches in a Nutshell
신뢰 자료: Atlassian - Using branches