[Git/Github] Github 저장소에 Readme만 있을 때 내 프로젝트를 Push하면 발생하는 오류 (error: failed to push some refs to)

이슈상황

Github에 repository를 생성할 때 readme를 같이 생성.

원격저장소를 remote로 연결하여 내 로컬에 있는 프로젝트를 원격 저장소로 push 할 때 이슈 발생.

 

오류발생화면

[error: failed to push some refs to] 오류가 발생 원인을 확인해 보니 원격저장소에는 Readme 파일이 있는데 로컬에는 없을 경우 발생된다고 한다. 

 

해결 방안 

1. 강제로 push 하기 

제일 간단한 방법이지만 원격저장소의 파일이 훼손될 수 있다. 

아직 원격저장소에 특별한 작업이 없다면 이 방법을 추천한다.

만약 원격저장소 Readme 등을 작업하고 있으면 백업 후 진행하거나 아래 방식을 이용한다.(다 날아감) 

git push origin +main

 

2. git pull (권장 방법) 

hint를 확인하자

해당 오류를 확인해보면 [git pull ... ]를 진행할 것을 힌트로 준다. 

 

원격 저장소 브랜치의 정보를 로컬저장소로 먼저 'pull'을 진행하여 로컬 저장소로 가져온다.  

git pull origin main

그런 다음 똑같이 로컬 저장소를 푸시를 진행하면 정상 진행된다. 

git add .
git commit -m " "
git push origin main

 

이 방법은 원격 저장소의 파일 손실 없이 진행되는 방식이므로 안전하게 처리될 수 있다. 

 

Reference

https://myvelop.tistory.com/26