시스매

깃 병합 전략 핸드북_ 초보자에서 중급자까지

12 min read

‘깃 병합 전략’에 관해 만들어진 이유에서 구조, 사용법 등을 통합한 하나의 핸드북 형식의 요약 만들어줘. 초보, 중수. 전체

깃 병합 전략 핸드북: 초보자에서 중급자까지

개요

깃 병합 전략은 소프트웨어 개발에서 여러 브랜치의 변경사항을 통합하는 핵심 기능으로, 프로젝트의 히스토리 관리와 협업 효율성에 직접적인 영향을 미칩니다1. 각 전략은 고유한 장단점을 가지고 있어 상황에 맞는 선택이 중요합니다2.

병합 전략이 만들어진 이유

깃 병합 전략은 분산 버전 관리 시스템에서 여러 개발자가 동시에 작업할 때 발생하는 문제를 해결하기 위해 개발되었습니다3. 초기 버전 관리 시스템들은 단순한 병합만 지원했지만, 복잡한 프로젝트에서는 다음과 같은 문제들이 발생했습니다:

  • 브랜치 히스토리의 복잡성: 여러 브랜치가 동시에 개발될 때 히스토리 추적의 어려움
  • 충돌 해결의 복잡성: 같은 파일을 여러 개발자가 수정할 때 발생하는 문제
  • 협업 효율성: 팀 규모와 프적화 필요성

이러한 문제들을 해결하기 위해 깃은 다양한 병합 전략을 제공하게 되었습니다4.

주요 병합 전략의 구조와 원리

1. Fast-Forward Merge

구조와 원리: Fast-Forward 병합은 대상 브랜치가 소스 브랜치로부터 분기된 이후 새로운 커밋이 없을 때 발생합니다1. 깃은 단순히 브랜치 포인터를 최신 커밋으로 이동시킵니다5.

Before:   A---B---C (main)
               \
                D---E (feature)

After:    A---B---C---D---E (main)

사용법:

git checkout main
git merge feature-branch
# 자동으로 fast-forward 실행

특징:

  • 히스토리 보존: 선형적인 커밋 히스토리 유지1
  • 단순성: 추가 병합 커밋 생성하지 않음5
  • 제한사항: 브랜치가 분기되지 않은 경우에만 가능6

깃 병합 전략별 특성 비교 차트

깃 병합 전략별 특성 비교 차트

2. 3-Way Merge (Recursive Merge)

구조와 원리: 깃의 기본 병합 전략으로, 두 브랜치와 공통 조상 커밋을 비교하여 새로운 병합 커밋을 생성합니다4. 이는 가장 일반적으로 사용되는 전략입니다7.

Before:   A---B---C---F (main)
               \
                D---E (feature)

After:    A---B---C---F---G (main)
               \         /
                D---E---/

사용법:

git checkout main
git merge feature-branch
# 자동으로 3-way merge 실행 및 병합 커밋 생성

장점:

  • 완전한 히스토리 보존: 모든 브랜치의 컨텍스트 유지3
  • 충돌 해결 용이: 한 번에 모든 충돌 표시8
  • 협업 친화적: 여러 개발자 작업 추적 가능9

단점:

  • 복잡한 그래프: 많은 병합 시 히스토리 복잡해짐10
  • 병합 커밋 증가: 추가 커밋으로 인한 노이즈9

3. Squash and Merge

구조와 원리: 여러 커밋을 하나의 커밋으로 압축하여 병합하는 전략입니다11. 기능 브랜치의 모든 변경사항을 단일 커밋으로 통합합니다12.

Before:   A---B---C (main)
               \
                D---E---F (feature)

After:    A---B---C---G (main)
          (G는 D+E+F의 통합 커밋)

사용법:

git checkout main
git merge --squash feature-branch
git commit -m "기능 추가: 새로운 로그인 시스템"

적용 상황:

  • 소규모 기능: 작은 기능이나 버그 수정12
  • 실험적 브랜치: 시행착오가 많은 개발 과정11
  • 깔끔한 히스토리: 메인 브랜치의 단순성 유지13

4. Rebase and Merge

구조와 원리: 브랜치의 베이스를 다른 커밋으로 이동시켜 선형적인 히스토리를 만드는 전략입니다14. 커밋들을 새로운 위치에 재적용합니다15.

Before:   A---B---C---F (main)
               \
                D---E (feature)

After:    A---B---C---F---D'---E' (main)
          (D', E'는 리베이스된 새로운 커밋)

사용법:

git checkout feature-branch
git rebase main
git checkout main
git merge feature-branch  # fast-forward merge

주의사항:

  • 공유 브랜치 금지: 원격 저장소에 푸시된 커밋은 리베이스 금지14
  • 해시 변경: 커밋 SHA 값이 변경됨16
  • 협업 문제: 다른 개발자와의 동기화 문제 발생 가능8

고급 병합 전략

Octopus Merge

여러 브랜치를 동시에 병합하는 전략입니다4. 복잡한 충돌이 없는 경우에만 사용 가능합니다7.

git merge -s octopus branch1 branch2 branch3

Subtree Merge

외부 프로젝트를 서브디렉토리로 병합할 때 사용합니다4.

git merge -s subtree external-project

Ours Strategy

현재 브랜치의 변경사항만 유지하고 다른 브랜치는 무시합니다4.

git merge -s ours unwanted-branch

충돌 해결 방법

기본 충돌 해결 과정

  1. 충돌 파일 확인:
git status  # 충돌 파일 목록 확인
  1. 수동 편집:
<<<<<<< HEAD
현재 브랜치의 내용
=======
병합할 브랜치의 내용
>>>>>>> feature-branch
  1. 충돌 해결 완료:
git add conflicted-file.txt
git commit -m "충돌 해결: 로그인 기능 통합"

자동 충돌 해결 도구

병합 도구 사용:

git mergetool  # 시각적 병합 도구 실행

전략적 해결:

git merge -X ours feature-branch    # 현재 브랜치 우선
git merge -X theirs feature-branch  # 병합 브랜치 우선

상황별 최적 전략 선택 가이드

팀 규모별

소규모 팀 (1-3명):

  • Rebase + Fast-Forward: 깔끔한 히스토리 우선8
  • Squash Merge: 실험적 기능 개발시9

중규모 팀 (4-10명):

  • 3-Way Merge: 협업과 히스토리 균형3
  • Feature Branch + Merge Commit17

대규모 팀 (10명 이상):

  • 3-Way Merge: 완전한 추적성 필요9
  • GitFlow 워크플로우 적용17

프로젝트 특성별

제품 개발:

  • 안정성과 추적성 중시
  • 3-Way Merge 권장18

오픈소스 프로젝트:

  • 기여자 히스토리 보존
  • Merge Commit 사용18

프로토타입/실험:

  • 빠른 개발과 깔끔한 히스토리
  • Squash Merge 적합11

베스트 프랙티스

병합 전 준비사항

  1. 정기적인 동기화:
git fetch origin
git merge origin/main  # 또는 git pull origin main
  1. 브랜치 정리:
git rebase -i HEAD~3  # 로컬에서 커밋 정리
  1. 테스트 확인:
npm test  # 또는 해당 프로젝트의 테스트 명령

커밋 메시지 규칙

# 좋은 예
git commit -m "feat: 사용자 인증 API 추가
 
- JWT 토큰 기반 인증 구현
- 로그인/로그아웃 엔드포인트 추가
- 입력값 검증 로직 포함"
 
# 나쁜 예
git commit -m "수정"

브랜치 네이밍 컨벤션

feature/user-authentication    # 새 기능
bugfix/login-error-fix        # 버그 수정
hotfix/security-patch         # 긴급 수정
release/v1.2.0                # 릴리스 준비

도구 및 환경 설정

GUI 도구 활용

인기 있는 깃 GUI 도구:

  • GitKraken: 시각적 브랜치 관리8
  • SourceTree: 무료 Atlassian 도구
  • GitHub Desktop: 간단한 깃허브 연동
  • Visual Studio Code: 내장 깃 기능19

IDE 통합

IntelliJ IDEA/WebStorm:

  • 3-way 병합 에디터 제공
  • 자동 충돌 탐지 및 해결 제안

Visual Studio Code:

  • GitLens 확장으로 향상된 깃 경험
  • 인라인 충돌 해결 도구19

문제 해결 및 복구

잘못된 병합 취소

# 병합 직후 (커밋 전)
git merge --abort
 
# 병합 완료 후
git reset --hard HEAD~1  # 주의: 작업 내용 손실

복잡한 충돌 상황

# 단계적 해결
git checkout --ours filename     # 현재 브랜치 버전 선택
git checkout --theirs filename   # 병합 브랜치 버전 선택
git add filename
git commit

히스토리 복구

# reflog를 이용한 복구
git reflog                # 최근 작업 이력 확인
git reset --hard HEAD@{2} # 특정 지점으로 복구

결론

깃 병합 전략의 선택은 팀의 규모, 프로젝트의 특성, 그리고 유지보수의 필요성을 종합적으로 고려해야 합니다8. 초보자는 3-Way Merge로 시작하여 기본기를 익히고, 중급자는 상황에 맞는 전략을 선택할 수 있는 판단력을 기르는 것이 중요합니다9.

성공적인 깃 워크플로우는 기술적 측면뿐만 아니라 팀 문화와 커뮤니케이션에도 크게 의존합니다17. 정기적인 코드 리뷰, 명확한 브랜치 전략, 그리고 일관된 커밋 메시지 규칙을 통해 효율적인 협업 환경을 구축할 수 있습니다20.

핵심 권장사항:

  • 팀 내에서 일관된 전략 합의
  • 충돌 최소화를 위한 정기적 동기화
  • 명확한 커밋 메시지와 브랜치 네이밍
  • 상황에 맞는 도구 활용
  • 지속적인 학습과 개선
⁂

Footnotes

  1. https://www.geeksforgeeks.org/merge-strategies-in-git/ ↩ ↩2 ↩3

  2. https://www.atlassian.com/git/tutorials/using-branches/git-merge ↩

  3. https://www.datacamp.com/tutorial/git-merge ↩ ↩2 ↩3

  4. https://www.baeldung.com/ops/git-merge-strategies ↩ ↩2 ↩3 ↩4 ↩5

  5. https://lukemerrett.com/different-merge-types-in-git/ ↩ ↩2

  6. https://www.w3schools.com/git/git_branch_merge.asp?remote=github ↩

  7. https://www.atlassian.com/git/tutorials/using-branches/merge-strategy ↩ ↩2

  8. https://mangchhe.github.io/git/2021/09/04/GitMerge/ ↩ ↩2 ↩3 ↩4 ↩5

  9. https://www.geeksforgeeks.org/git/git-merge/ ↩ ↩2 ↩3 ↩4 ↩5

  10. https://johngrib.github.io/wiki/git/merge/ ↩

  11. https://velog.io/@shinyejin0212/Git에서-branch-merge-방법들과-각-방법의-특징을-설명해-주세요 ↩ ↩2 ↩3

  12. https://git-scm.com/book/ko/v2/Git-브랜치-브랜치와-Merge-의-기초 ↩ ↩2

  13. https://nuritech.tistory.com/33 ↩

  14. https://velog.io/@king_nono_1030/git-merge ↩ ↩2

  15. https://codingmax.net/courses/git-commands/section03/lec0002 ↩

  16. https://git-scm.com/docs/merge-strategies ↩

  17. https://dev-district.tistory.com/21 ↩ ↩2 ↩3

  18. https://takeknowledge.tistory.com/121 ↩ ↩2

  19. https://velog.io/@yujuck/Git-Merge-전략 ↩ ↩2

  20. https://git-scm.com/docs/git-merge ↩

그래프 뷰

백링크