개발 초보자를 위한 Git 브랜치 전략: feature 브랜치로 안전하게 개발하고 main에 병합하는 기본 흐름

처음 Git으로 협업(혹은 혼자 프로젝트)을 시작하면 제일 무서운 순간이 있습니다. “main에서 작업하다가 망치면 어쩌지?” 실제로 초보 시절엔 급하게 수정하다가 동작하던 기능을 깨뜨리거나, 되돌리려다 커밋이 꼬이는 경험을 한 번쯤 하게 됩니다.

1) 브랜치는 왜 필요할까?

브랜치는 한마디로 작업을 분리하는 안전장치입니다.

• main: 언제든 배포/실행 가능한 “기준선”
• feature/*: 특정 기능을 개발하는 “작업 공간” 즉, 기능 개발 중에는 실수해도 main이 깨지지 않습니다. 개발 초보자에게 이게 정말 큽니다.

2) 추천하는 기본 브랜치 구조

브랜치 이름 규칙(간단 버전)

• main : 안정 버전
• feature/login : 로그인 기능
• feature/profile-edit : 프로필 수정 기능 팀마다 규칙이 다를 수 있지만, 초보자라면 “feature/기능명” 정도로 시작하면 충분합니다.

3) 실전 기본 흐름: feature 만들고 main에 병합하기

아래는 가장 많이 쓰는 “정석 루틴”입니다.

1) 최신 main 받기

git switch main
git pull origin main

main이 최신 상태인지 확인하고 시작합니다. 이 습관이 충돌을 줄여줘요.

2) feature 브랜치 만들고 이동

git switch -c feature/login

이제부터의 모든 수정은 feature/login에서만 합니다.

3) 작업하고 작은 단위로 커밋

git status
git add .
git commit -m "Add login form UI"

커밋 메시지는 무엇을 했는지 한 문장으로 남기면 나중에 되돌리기도 쉽습니다. 가능하면 “한 커밋 = 한 변화”로 작게 쪼개는 게 좋아요.

4) 원격에 푸시

git push -u origin feature/login

-u를 붙이면 다음부터는 git push만 해도 같은 브랜치로 올라갑니다.

5) main 최신 변경 반영(병합 전 정리)

기능 개발 중 다른 사람이 main을 바꿨을 수 있어요. 병합 전에 내 브랜치에 main을 한 번 반영하면 충돌이 줄어듭니다.

git switch main
git pull origin main
git switch feature/login
git merge main

충돌이 나면 파일을 열어 충돌 표시를 해결한 뒤:

git add .
git commit -m "Merge main into feature/login"

6) main에 병합

로컬에서 병합하는 기본 형태는 이렇게 갑니다.

git switch main
git merge feature/login

병합이 끝나면 원격 main에 반영:

git push origin main

7) 브랜치 정리(선택이지만 강력 추천)

git branch -d feature/login

원격 브랜치까지 지우려면:

git push origin --delete feature/login

작업이 끝난 브랜치를 정리하면 저장소가 깔끔해지고, “지금 진행 중인 작업”도 더 명확해집니다.

4) 초보자가 자주 하는 실수 3가지와 예방 팁

실수 1) main에서 바로 개발해버림

급해서 main에서 수정하고 커밋해버리는 경우가 많습니다. 예방 팁: 작업 시작 전, 먼저 git branch로 내가 어디 있는지 확인하는 습관을 들이세요.

실수 2) 기능 여러 개를 한 브랜치에 섞음

feature/login에서 로그인도 하고, 프로필 수정도 하고… 이렇게 섞이면 되돌리기 힘들어집니다. 예방 팁: 기능이 달라지면 브랜치를 새로 파세요. 브랜치는 공짜입니다.

실수 3) 커밋을 너무 크게 한 번에 함

나중에 “어디서 문제가 생겼지?”를 찾기 어려워요. 예방 팁: UI, API 연동, 예외처리처럼 덩어리를 나눠 커밋하세요.

5) 작은 예시 시나리오로 감 잡기

예를 들어 “로그인 버튼을 누르면 서버에 요청하고 성공 시 홈으로 이동”을 만든다고 해볼게요.

• feature/login 브랜치 생성
• 1차 커밋: 로그인 화면 UI 추가
• 2차 커밋: 로그인 API 호출 코드 추가
• 3차 커밋: 에러 메시지 처리
• 병합 전 main 최신 반영
• main에 병합 후 브랜치 삭제 이렇게 하면 문제가 생겨도 특정 커밋만 되돌리기 쉽고, 기능 단위가 명확해져서 협업에도 강합니다.

마무리: “main은 안전지대”로 두는 습관이 실력을 만든다

개발 초보자일수록 중요한 건 속도보다 안전하게 실수할 수 있는 구조입니다. feature 브랜치를 쓰면 마음 편하게 실험하고, 검증된 것만 main에 올릴 수 있어요. 오늘 소개한 흐름대로만 반복해도, Git이 갑자기 어렵게 느껴지는 순간이 확 줄어들 겁니다.