# 머지 (Merge)

## 개요/소개
머지는 버전 관리 시스템에서 두 가지 서로 다른 코드베이스를 통합하는 과정을 의미합니다. 주로 Git과 같은 분산 버전 관리 도구에서 사용되며, 협업 프로젝트에서 여러 개발자가 독립적으로 작업한 변경 사항을 하나의 최신 상태로 합치는 데 필수적입니다. 머지 과정은 코드 충돌(Conflict) 발생 시 해결이 필요하며, 올바른 전략을 선택하는 것이 중요합니다.

---

## 머지의 개념

### 정의
머지는 두 개 이상의 **트리**(Tree) 또는 **브랜치**(Branch)를 결합하여 하나의 새로운 트리를 생성하는 작업입니다. 예를 들어, `main` 브랜치와 `feature` 브랜치의 변경 사항을 통합할 때 사용됩니다.

### 중요성
- **협업 효율성**: 여러 개발자가 동시에 작업한 코드를 통합하여 최신 상태 유지.
- **변경 사항 추적**: 어떤 변경이 언제, 누구에 의해 적용되었는지 명확히 기록.
- **안정성 확보**: 테스트된 코드와 새로운 기능을 결합해 안정적인 릴리스 준비.

---

## 머지의 종류 및 방식

### 타입
1. **Fast-forward Merge**  
   - 한 브랜치가 다른 브랜치의 변경 사항을 완전히 포함할 때, 커밋 히스토리를 단순히 이동시킴.  
   - 예: `main` 브랜치에 `feature` 브랜치를 머지하고, `feature`가 `main`의 최신 상태를 가질 경우.

2. **Three-way Merge**  
   - 두 브랜치의 공통 조상(Ancestor)과 각각의 변경 사항을 비교해 새로운 커밋을 생성.  
   - 충돌이 발생할 수 있으며, 수동으로 해결해야 함.

3. **Rebase vs. Merge**  
   - `rebase`는 기존 커밋 히스토리를 재정렬하는 반면, `merge`는 두 트리를 병합합니다.  
   - `rebase`는 깔끔한 히스토리 생성에 유리하지만, 공유 브랜치에서 사용 시 주의가 필요.

### 전략
| 전략 | 설명 | 예시 |
|------|------|------|
| **Recursive** | 기본 전략으로, 복잡한 트리 구조를 처리. | `git merge --strategy=recursive` |
| **Octopus** | 여러 브랜치를 동시에 머지. | `git merge --octopus` |
| **Ours/Theirs** | 충돌 시 특정 측의 변경 사항을 우선 적용. | `git merge -s recursive -X ours` |

---

## 머지 과정

### 단계
1. **브랜치 전환**: `git checkout main`  
2. **머지 실행**: `git merge feature-branch`  
3. **충돌 해결**: 텍스트 에디터에서 충돌 파일 열기, `<<<<<<<`, `=======`, `>>>>>>>` 구분자 확인.  
4. **커밋 완료**: `git commit`

### 예시
```bash
# main 브랜치로 전환
git checkout main

# feature-branch 머지
git merge feature-branch

# 충돌 발생 시 해결 후 커밋
git add .
git commit -m "Merge feature-branch into main"
```

---

## 최선의 실천 방법

1. **정기적인 머지**: 주기적으로 `main` 브랜치와 통합해 충돌을 사전에 방지.
2. **작은 단위로 분할**: 대규모 변경은 작은 기능 단위로 나누어 머지.
3. **자동화 도구 활용**: CI/CD 파이프라인에서 자동 머지 및 테스트 실행.
4. **명확한 커밋 메시지**: 머지 시 `Merge branch 'feature' into main`과 같은 형식 사용.

---

## 일반적인 문제 및 해결책

### 충돌 발생
- **원인**: 동일 파일의 동일 라인에서 두 개 이상의 변경 사항이 적용됨.
- **해결 방법**:  
  1. `git status`로 충돌 파일 확인.  
  2. 텍스트 에디터에서 수동으로 수정.  
  3. `git add <파일명>` 후 `git commit`.

### 머지 실패
- **원인**: 네트워크 문제, 권한 부족, 브랜치 충돌.
- **해결 방법**:  
  - `git fetch`로 최신 상태 확인.  
  - `git pull --rebase`를 사용해 히스토리 재정렬.

---

## 참고 자료
- [Git 공식 문서: Merge](https://git-scm.com/book/ko/v2/%EB%B6%80%EC%97%85-%EA%B3%A0%ED%94%8C%EB%9D%BC%EC%9A%A9-%EB%AA%A9%EB%A1%9D)
- [GitHub: Merge vs. Rebase](https://docs.github.com/ko/pull-requests/collaborating-with-pull-requests/working-with-forks/merging-and-rebasing-code)
- [Stack Overflow: Git Merge Conflict Resolution](https://stackoverflow.com/questions/161813/how-to-resolve-git-merge-conflicts)

--- 

이 문서는 버전 관리 시스템에서 머지의 개념, 방식, 실천 방법을 체계적으로 설명하며, 실제 개발 환경에서 유용한 정보를 제공합니다.