완성된 기능 메인 브랜치에 안전하게 합치기

하나로 합쳐지는 강물: 병합(Merge)의 개념

`main`이라는 큰 강물이 흐르고 있고, 우리는 거기서 물길을 얇게 하나 파내어 `feature-darkmode`라는 작은 시냇물을 만들었습니다. 이 시냇물에서 우리는 온갖 실험을 성공적으로 마쳤습니다. 이제 이 맑아진 시냇물을 다시 원래의 큰 강물(`main`)로 돌려보내어 강물의 수량을 불려야 합니다.

`git merge`는 이렇게 나뉘었던 두 개의 브랜치(역사의 흐름)를 하나로 묶어주는 명령어입니다. 여기서 헷갈리지 말아야 할 아주 중요한 규칙이 하나 있습니다.

"흡수 당하는 쪽에서 명령을 내리는 것이 아니라, 흡수하는 주체(주인공)의 입장에서 빨아들일 대상을 지목해야 한다"는 것입니다. 우리는 `feature` 시냇물을 `main` 강물로 가져올 것이므로, 현재 내 위치는 반드시 넓은 강물인 `main` 브랜치여야 합니다.

실전 병합의 3단계 흐름

병합을 수행하는 과정은 항상 다음의 3단계를 기계적으로 따르게 됩니다.

1. 주인공 브랜치로 이동하기 (`checkout`)

가장 먼저 내가 돌아갈 고향이자 모든 것을 흡수할 본체인 `main` 브랜치로 넘어와야 합니다. 터미널에 `git checkout main` (또는 `git switch main`)을 쳐서 포털을 탑니다. `main`에 오자마자 코드를 확인해 보면, 우리가 열심히 만들었던 다크모드 코드가 감쪽같이 사라진 것을 보고 놀라게 됩니다. 당연합니다. 다크모드는 시냇물에만 있고 여기 강물에는 아직 합쳐지지 않았기 때문입니다.

$ git checkout main
Switched to branch 'main'

2. 대상 브랜치를 지목하여 합치기 (`merge`)

이제 주인공의 입장에서 흡수할 대상을 명령어로 부릅니다. 터미널에 `git merge feature-darkmode`라고 입력합니다. "저기 있는 `feature-darkmode` 브랜치의 모든 작업 내역을 싹 다 지금 내가 있는 이 `main` 브랜치로 끌고 와서 합쳐라!"라는 뜻입니다.

```bash
$ git merge feature-darkmode
Updating 1a2b3c4..5f6g7h8
Fast-forward
 index.html | 2 ++
 style.css  | 5 +++++
 2 files changed, 7 insertions(+)
```

성공 메시지를 본 후 `index.html` 파일을 다시 열어보면, 사라졌던 다크모드 버튼 코드가 `main` 기둥에 예쁘게 안착해 있는 것을 확인할 수 있습니다! 방문자들에게 새로운 기능을 서비스할 준비가 완료된 것입니다.

3. 다 쓴 평행우주 폭파시키기 (선택사항)

기능도 완벽히 합쳤으니, `feature-darkmode`라는 나뭇가지는 이제 그 소임을 다했습니다. 계속 놔두면 나중에 브랜치가 수십 개로 늘어나 터미널 화면이 지저분해집니다. 이미 코드는 `main`에 모두 안전하게 복사되었으므로, 과거의 껍데기만 남은 이 브랜치는 깔끔하게 지워주는 것이 프로들의 관습입니다.

브랜치를 삭제할 때는 소문자 `-d` 옵션을 씁니다. `git branch -d feature-darkmode`를 입력하면 "Deleted branch..." 메시지와 함께 평행우주가 역사 속으로 사라집니다. (소문자 `-d`는 이미 병합이 완료된 안전한 브랜치만 지워주는 똑똑한 옵션이며, 대문자 `-D`는 병합 안 된 것도 강제로 날려버리는 위험한 옵션입니다.)

우리는 이제 기능마다 나뭇가지를 치고(`branch`), 안전하게 코드를 짜고 테스트한 뒤(`commit`), 다시 튼튼한 기둥으로 합치는(`merge`) 고급 기술을 익혔습니다. 바이브코딩으로 아무리 복잡한 기능을 추가하더라도 이 패턴 안에서는 절대 원본 코드가 무너질 일이 없습니다.