본문 바로가기
성공지식백과 로고성공지식백과
GLOSSARY

브랜치 (Branch)

중급바이브 코딩

이 페이지는 바이브 코딩 문맥에서 자주 쓰이는 브랜치 (Branch)의 뜻과 쓰임을 중급 난이도 기준으로 정리한 AI 용어사전 항목입니다. 정의와 맥락, 관련 용어 5개 순서로 묶었으니, 아래 설명을 먼저 읽고 연결된 개념과 글까지 이어서 보면 이해가 빨라집니다.

브랜치(Branch)는 Git에서 특정 커밋을 가리키며 새 커밋에 따라 이동하는 이름 있는 참조입니다. 같은 저장소 안에서 작업 흐름을 나누는 데 사용합니다. 브랜치 이름이 같아도 로컬과 원격의 위치는 다를 수 있고, 브랜치를 만들거나 바꾸는 동작과 변경 내용을 병합하는 동작은 서로 구분합니다.

커밋을 따라 이동하는 참조

Git 공식 책의 브랜치 설명은 브랜치를 커밋을 가리키는 가벼운 이동 가능한 포인터라고 설명합니다. 기능을 추가하기 위해 브랜치를 만들면 그 시점의 커밋을 가리키는 이름이 생깁니다. 그 브랜치에서 커밋을 추가하면 이름이 새 커밋으로 이동합니다. 다른 브랜치는 계속 이전 커밋을 가리킬 수 있어, 한 저장소에서 서로 다른 변경 흐름을 이어 갈 수 있습니다.

이 방식은 프로젝트 폴더 전체를 별도의 사본으로 복사해 관리하는 것과 다릅니다. 브랜치들이 함께 가진 과거 커밋은 이력에서 공유합니다. 두 브랜치가 같은 커밋을 가리키면 서로 다른 이름이 붙어 있어도 기록된 파일 상태는 같습니다. 이후 한쪽에 커밋을 추가하면 참조 위치가 달라집니다. 파일 몇 개가 달라 보이는지만 확인하기보다 브랜치가 가리키는 커밋과 두 이력이 갈라진 지점을 보면 변경 관계를 설명할 수 있습니다.

작업 이름만으로 포함된 변경을 판단하지 않습니다. 같은 이름을 다시 만들거나 시작점을 다르게 고를 수 있으므로 검토할 때는 이름과 커밋 위치를 함께 읽습니다.

브랜치 생성과 작업 대상 전환

git branch 명령 문서는 브랜치를 만들고 나열하고 삭제하는 기능을 설명하며, 새 브랜치를 만드는 것만으로 작업 대상이 그 브랜치로 바뀌지는 않는다고 명시합니다. 이름을 만들었다는 사실과 그 이름을 선택했다는 사실은 구별됩니다. 현재 선택한 브랜치에서는 이후 커밋이 어느 참조를 이동시킬지 정해지므로 작업을 시작할 때 선택된 이름을 확인하는 것이 실제 변경 위치를 파악하는 방법입니다.

공식 책은 HEAD를 현재 작업 위치를 가리키는 특별한 참조로 설명합니다. 보통 브랜치를 선택해 작업할 때 HEAD는 그 브랜치를 가리킵니다. 다른 브랜치로 전환하면 작업 폴더의 파일도 대상 커밋의 상태에 맞게 바뀝니다. 아직 커밋하지 않은 변경 때문에 안전하게 바꿀 수 없는 경우 Git이 전환을 막을 수 있습니다. 브랜치 이름을 바꾸는 일, 작업 대상을 전환하는 일, 파일 내용을 수정하는 일은 화면에서 이어져 보여도 각각 다른 동작입니다.

브랜치 목록에는 로컬 브랜치와 원격 추적 브랜치가 함께 나타날 수 있습니다. 원격 추적 참조는 원격 저장소의 상태를 마지막으로 가져왔을 때의 위치를 기록합니다. 원격 서버가 계속 변할 수 있으므로 그 참조를 보고 실시간 상태까지 같다고 단정하지 않습니다. 로컬 브랜치의 변경을 원격에 반영하는 푸시와 원격의 변경 정보를 가져오는 동작을 나누어 확인합니다.

병합과 브랜치 삭제의 의미

두 브랜치의 변경을 합치는 작업은 머지입니다. 브랜치는 작업 흐름을 가리키고 머지는 그 흐름의 변경을 통합하는 동작이므로 이름을 만들었다고 코드가 자동으로 합쳐지지는 않습니다. 풀 리퀘스트도 브랜치 자체와 다릅니다. GitHub 같은 협업 서비스에서 브랜치 사이의 변경을 검토하고 병합을 제안하는 기록이며, 실제 Git 이력과 검토 상태를 함께 확인할 때 어떤 변경이 받아들여졌는지 알 수 있습니다.

브랜치를 삭제하면 해당 이름의 참조가 없어집니다. 다른 참조에서 계속 도달할 수 있는 커밋은 그 이력에 남습니다. 반대로 다른 곳에서 보존하지 않은 작업을 가리키는 이름을 지우면 나중에 찾기 어려워질 수 있습니다. git branch 문서는 일반 삭제와 강제 삭제의 조건을 구분합니다. 원격 브랜치 삭제도 로컬 이름을 지우는 것과 별도 작업이므로, 완료된 기능을 정리할 때는 어떤 저장소의 어떤 참조를 없애는지 확인합니다.

RELATED TERMS

관련 용어

브랜치 (Branch)와 함께 자주 언급되는 개념들입니다. 비슷한 말처럼 보여도 역할과 쓰임은 다를 수 있습니다.