기획자를 위한 깃허브 실전 ③브랜치(Branch) — 안전하게 수정하고 실험하는 방법

깃허브에서 “브랜치(branch)”는 프로젝트의 또 다른 작업공간입니다. 기획자가 문서를 관리하거나 개발자와 협업할 때, “원본은 그대로 두고 수정본만 따로 만들기”가 필요할 때가 있죠? 그게 바로 브랜치의 역할입니다. 이 글에서는 “브랜치가 왜 필요한지”와 “VS Code에서 브랜치를 다루는 기초”를 기획자 관점에서 쉽게 설명합니다.

---

브랜치란 무엇일까?

브랜치(branch)는 한마디로 말해 복사된 작업 공간입니다. 현재 진행 중인 코드나 문서를 복사해 새로운 버전의 실험 환경을 만드는 개념이에요.

예를 들어,

• main 브랜치: 공식 배포용 버전
• design-update 브랜치: 디자인 수정용
• policy-change 브랜치: 약관 변경 시 테스트용

이렇게 브랜치를 나누면, 누구나 자유롭게 수정해도 원본(main)은 손상되지 않습니다.

---

브랜치의 핵심 개념 요약

용어	의미	비유
main (또는 master)	공식 버전	완성된 원고
branch	실험용 버전	복사한 원고 사본
merge	브랜치의 변경 내용을 합치기	편집본을 원고에 반영하기
checkout / switch	작업 중인 브랜치 이동	사본과 원본 사이를 오가며 보기

---

브랜치를 사용하는 이유

1. 안전한 실험 가능 → 원본을 건드리지 않고 새 아이디어나 기능을 테스트할 수 있습니다.
2. 협업 중 충돌 방지 → 여러 사람이 같은 파일을 편집해도 브랜치가 다르면 충돌이 줄어듭니다.
3. 히스토리 관리 용이 → 어떤 수정이 언제, 왜 이루어졌는지 명확하게 구분할 수 있습니다.

---

VS Code에서 브랜치 만들기

현재 브랜치 확인

VS Code 하단의 왼쪽 아래 상태바를 보면 현재 브랜치 이름이 표시됩니다. 보통은 main으로 되어 있습니다.

새 브랜치 생성

• 상태바의 main을 클릭 → “Create new branch” 선택
• 브랜치 이름 입력 (예: update-readme, design-test)

작업 후 커밋 & 푸시

이제 브랜치 안에서만 수정이 적용됩니다. 작업이 끝나면 터미널에서 다음 명령으로 저장합니다.

git add .
git commit -m "Updated README for design test"
git push --set-upstream origin update-readme

이 명령은 터미널(Terminal) 창에서 실행해야 합니다. VS Code에서 상단 메뉴 → [보기] → [터미널] 클릭으로 열 수 있습니다.

브랜치 병합(merge)

검토 후 변경 내용을 원본(main)에 반영하려면, GitHub 웹 화면에서 “Pull Request”를 생성하고 Merge합니다. → 원본이 안전하게 업데이트됩니다.

---

기획자를 위한 브랜치 예시

상황	브랜치 이름	설명
디자인 가이드 수정	design-guide	기획자가 디자인 관련 문서를 수정할 때
약관 업데이트 테스트	policy-update	정책 문서 변경 테스트용
기능 설명서 개선	feature-doc	개발자용 매뉴얼 보완 시
프로토타입 검토	prototype-test	Figma 시안에 맞춘 문서 업데이트용

---

한눈에 보는 브랜치 흐름

(main)  ← 기존 원본
   │
   ├── (policy-update)  ← 정책 변경 작업
   │       수정 중...
   │       └── merge → main 반영 완료
   │
   └── (design-guide)  ← 디자인 문서 실험용
           └── merge → main 반영 완료

---

브랜치를 처음 쓰는 기획자에게 드리는 팁

• 브랜치는 “파일 복사본”이라 생각하면 쉽습니다.
• 수정은 자유롭게, 합칠 때는 신중하게.
• 파일 이름보다 “브랜치 이름”으로 작업 구분하는 습관을 들이면 협업 시 훨씬 깔끔하게 관리됩니다.