Git 원격 레포 생성 및 로컬 연동 시 초기 설정 정리

GitHub에서 원격 레포를 만든 뒤 로컬 폴더와 연동하는 과정은 단순해 보이지만,
막상 진행하다 보면 브랜치 불일치, pull 순서, 사용자 정보 설정 등에서 시행착오를 겪기 쉽다.
이번 글에서는 실제로 많이 겪는 흐름을 기준으로 정석적인 초기 세팅 순서를 정리한다.

 

1. Git 사용자 정보 먼저 설정하기

커밋에는 반드시 작성자 이름과 이메일이 기록되므로,
첫 커밋 이전에 설정하는 것이 중요하다.

git config --global user.name "user_name"
git config --global user.email "your_email@example.com"

GitHub 계정에 등록된 이메일과 동일하게 설정하는 것이 좋다.

 

2. 로컬 프로젝트에서 Git 초기화

원격 레포를 만들었다고 해서 로컬이 자동으로 Git 관리 대상이 되지는 않는다.

git init

이 시점에서는 아직 원격 레포와 연결되지 않은 상태이다.

 

3. 원격 레포 연결

GitHub에서 생성한 레포 URL을 이용해 origin으로 연결한다.

git remote add origin https://github.com/계정명/레포명.git

연결 확인:

git remote -v

 

4. push 전에 반드시 pull 먼저

원격 레포 생성 시 .gitignore 또는 README.md를 함께 만들었다면
원격에 이미 커밋이 존재하는 상태다.

 

이 경우, push 전에 반드시 pull을 해야 한다.

git pull origin main

이 단계를 생략하면
unrelated histories, rejected 오류가 발생할 수 있다.

 

5. 브랜치 이름 불일치 문제 (master ↔ main)

git init의 기본 브랜치는 master,
GitHub의 기본 브랜치는 main인 경우가 많다.

 

현재 브랜치 확인:

git branch

master라면 main으로 통일한다.

git branch -M main

 

6. 첫 커밋 & upstream 설정 후 push

git add .
git commit -m "Initialize project structure"
git push -u origin main

-u 옵션으로 upstream을 설정하면
이후부터는 git push, git pull만 사용해도 된다.

 

7. 정리하면

초기 연동 정석 루트

git config --global user.name "이름"
git config --global user.email "이메일"
git init
git remote add origin 레포URL
git pull origin main
git branch -M main
git add .
git commit -m "Initialize project structure"
git push -u origin main

Git 초기 연동 과정에서의 대부분의 문제는

• pull 순서
• 브랜치 이름
• 사용자 정보 설정 시점

에서 발생한다

 

이 흐름만 기억해두면

새 레포 생성 → 로컬 연동 → 첫 커밋 까지막힘 없이 진행할 수 있다