스낵깃 🍪 - 중급편 #6: Fork된 레포와 메인 레포 동기화하는 법

Fork된 레포와 메인 레포 동기화하는 법

 

GitHub에서 협업을 하다 보면, Fork한 레포를 메인 레포와 동기화해야 하는 상황이 자주 발생한다.

Fork는 원본(메인) 레포의 복사본이지만, 메인 레포는 계속 업데이트되기 때문에 시간이 지나면 Fork한 레포와 차이가 발생할 수 있다.

따라서, 최신 상태를 유지하기 위해 Fork된 레포를 메인 레포와 동기화하는 과정이 필요하다.

 

이 글에서는 Fork한 레포를 최신 상태로 유지하는 방법을 단계별로 정리한다.

---

📌 Fork와 메인 레포의 관계

 

GitHub에서 Fork는 다른 사람의 레포를 내 계정으로 복사하는 과정이다.

Fork한 레포는 원본 레포와 연결되어 있지 않으므로, 메인 레포에서 변경 사항이 발생해도 자동으로 반영되지 않는다.

그렇다면, 어떻게 최신 상태로 동기화할 수 있을까?

 

🛠 Fork된 레포를 메인 레포와 동기화하는 과정

 

1. Fork한 레포를 로컬로 클론하기
2. 메인 레포를 원격 저장소(upstream)로 추가
3. 메인 레포의 최신 코드 가져오기
4. 내 로컬 브랜치에 병합하기
5. 충돌 발생 시 해결
6. Fork된 레포(origin)에도 변경 사항 반영(Push)

 

---

1️⃣ Fork한 레포 클론하기

 

우선, GitHub에서 Fork한 레포를 로컬로 가져와야 한다.

Fork한 레포의 URL을 확인한 후, 아래 명령어를 실행한다.

git clone <fork된 레포 URL>
cd <레포 폴더명>

예를 들어, GitHub에 있는 itstimi-XD/code-examples가 Fork한 레포일 경우:

git clone https://github.com/thombergs/code-examples.git
cd code-examples

✅ 이제 Fork한 레포가 로컬에 복사되었고, 해당 폴더로 이동할 수 있다.

---

2️⃣ 메인 레포를 원격 저장소로 추가하기

 

Fork한 레포는 메인 레포와 별도로 관리되므로, 메인 레포를 upstream으로 추가해야 한다.

git remote add upstream <메인 레포 URL>

예를 들어, 원본(메인) 레포가 thombergs/code-examples라면:

git remote add upstream https://github.com/thombergs/code-examples.git

✅ upstream을 추가하면, 이후 메인 레포의 변경 사항을 쉽게 가져올 수 있다.

---

3️⃣ 메인 레포의 최신 코드 가져오기

 

이제 upstream(메인 레포)에서 최신 코드를 가져온다.

git fetch upstream

✅ 이 명령어를 실행하면 upstream에서 최신 브랜치 정보를 가져오지만, 아직 로컬 브랜치에는 적용되지 않는다.

---

4️⃣ 내 브랜치에 메인 레포 병합하기

 

메인 레포에서 가져온 최신 변경 사항을 내 로컬 브랜치에 병합한다.

git merge upstream/main

✅ main 브랜치가 최신 상태로 업데이트된다.

✅ 만약 변경 사항이 충돌 없이 적용된다면, 여기서 완료!

✅ 하지만 Merge Conflict(충돌)이 발생할 수도 있다.

 

---

5️⃣ Merge Conflict(충돌) 해결하기

 

메인 레포의 변경 사항과 내 Fork 레포의 코드가 겹칠 경우, 자동 병합이 실패할 수 있다.

이 경우, Git이 충돌이 발생한 파일을 알려주므로 직접 수정해야 한다.

 

충돌 확인

git status

✅ 충돌이 발생한 파일을 확인하고 직접 수정한 후, 아래 명령어를 실행한다.

 

충돌 해결 후 커밋하기

git add .
git commit -m "Fix: Merge Conflict 해결"

✅ 충돌을 해결한 후, 변경 사항을 커밋한다.

---

6️⃣ Fork된 레포(origin)에 최신 코드 푸시

 

이제 최신 코드가 적용된 상태이므로, Fork된 레포(GitHub origin)에도 반영해야 한다.

git push origin main

✅ GitHub에 올라가 있는 Fork된 레포도 최신 코드로 동기화 완료! 🎉

✅ GitHub에서 PR(Pull Request)을 보낼 때, 최신 코드가 반영된 상태로 보낼 수 있다.

---

📌 요약 정리 📝

단계	명령어	설명
1️⃣	git clone <fork된 레포 URL>	Fork한 레포를 로컬에 클론
2️⃣	git remote add upstream <메인 레포 URL>	메인 레포(upstream)를 원격 저장소로 추가
3️⃣	git fetch upstream	메인 레포에서 최신 코드 가져오기
4️⃣	git merge upstream/main	최신 코드와 내 로컬 브랜치 병합
5️⃣	(충돌 발생 시) git status → git add . → git commit	충돌 해결 후 저장
6️⃣	git push origin main	Fork된 레포에도 최신 코드 반영

---

🔹 결론

• Fork된 레포는 메인 레포와 독립적으로 존재하므로, 지속적인 동기화가 필요하다.

• 메인 레포의 최신 변경 사항을 가져와 병합하는 과정에서 충돌이 발생할 수 있다.

• 충돌이 발생하면 직접 해결 후, 변경 사항을 커밋하여 업데이트한다.

• 최종적으로 git push origin main을 실행하면 GitHub의 Fork된 레포도 최신 상태로 유지된다.

 

이제 Fork 기반 협업을 더 효율적으로 할 수 있을 것이다! 🚀

다음 글에서는 Fork된 레포에서 변경 사항을 PR로 업데이트하는 방법을 다룰 예정이다. 🎉

---

📌 마무리하며

 

Fork 기반 협업을 할 때는 메인 레포와 지속적으로 동기화하는 것이 중요하다.

이제 git fetch upstream과 git merge를 활용하여 최신 상태를 유지하는 방법을 익혔으니,

GitHub에서 협업할 때 더 수월하게 진행할 수 있을 것이다.

 

다음 스낵깃에서는 Fork된 레포에서 충돌을 해결한 후 PR을 업데이트하는 과정을 다룰 예정이다!

기대해도 좋다! 😆 🚀