[Git] git pull origin main --allow-unrelated-histories (Merge branch 'main' of ~)

 

 

 

 

팀 프로젝트 초기 세팅 하다가 새롭게 알게 된 부분이 있어 정리해보려 한다.

 

CRA로 프로젝트를 생성하면 로컬에 자동으로 README.md 가 생성된다.

나는 로컬에서 작업을 완료한 뒤 깃허브에서 repo를 생성하고 둘을 연결하기 위해 git pull origin main --allow-unrelated-histories 를 했는데 pull 이 정상적으로 되지 않고, 소스 컨트롤 메세지에 Merge branch 'main' of ~ 뜨면서 README.md 파일을 merge하라고 떴다.

 

이유를 알아보니, 다음과 같은 이유에서 merge를 해야했었다.

git pull origin main --allow-unrelated-histories 명령은 로컬 브랜치와 원격 브랜치 간의 병합을 수행한다.

이때 --allow-unrelated-histories 옵션은 서로 관련이 없는 두 개의 브랜치의 기록을 병합하는 것을 허용하는데,  주로 로컬 저장소와 원격 저장소 간에 초기화되지 않은 저장소에서 사용된다. (ex. 이전에 로컬 브랜치에 커밋된 내용이 없거나, 원격 브랜치에 커밋된 내용이 없어서 두 브랜치의 기록이 서로 관련이 없는 경우)

이 명령을 실행하면 로컬 브랜치와 원격 브랜치의 변경 내용이 병합되고, 병합 충돌이 발생하지 않는 한 자동으로 병합된다. 하지만 병합 충돌이 발생한 경우에는 수동으로 충돌을 해결해야 한다.

 

나의 경우 원격 브랜치에 README.md 파일을 생성한 상태로 로컬 브랜치에 pull을 했기 때문에 충돌이 일어나게 되었다. 따라서 충돌을 일으키고 싶지 않다면 repo 생성시 README.md 파일을 생성하지 않고 CRA로 프로젝트를 생성해야 한다.