Git ↔ GitHub 데이터 흐름 가이드

로컬 저장소와 원격 저장소 사이를 자유롭게 오가기 위한 명령어 정리

1. 핵심 개념: 로컬과 원격은 다른 저장소

가장 먼저 머릿속에 그려둘 그림은 이거야. 커밋(commit)은 내 컴퓨터에만 저장되고, GitHub에 올리려면 push를 해야 해. 반대로 GitHub에서 바뀐 건 fetch나 pull로 가져와야 하고.

2. 명령어 분류표

A. 원격 "주소(연결)" 관리 — 보통 한 번만

B. 로컬 → 원격 (올리기)

C. 원격 → 로컬 (내려받기)

D. pull 동작 방식 설정

3. 시나리오별 사용법

# 로컬 작업 폴더에서
git init
git add .
git commit -m "first commit"

# GitHub에서 빈 저장소 만들고 주소 복사 → 연결
git remote add origin https://github.com/내이름/프로젝트.git
git remote -v                       # 연결 확인

git push -u origin main             # 첫 푸시 (-u로 추적 설정)

git clone https://github.com/내이름/프로젝트.git
cd 프로젝트
# 작업 → add → commit → push

git fetch                # 원격에 뭐 바뀌었는지 정찰만
git log origin/main      # 원격 최신 커밋 확인
git pull                 # 가져와서 합치기

git push                 ❌ 거절됨 ("rejected, non-fast-forward")

git pull                 # 원격 변경(B)을 내려받아 내 변경(A)과 merge
# (필요시 충돌 해결 → add → commit)
git push                 # 그 다음 push

git fetch
git status                       # "your branch is behind/ahead by N commits"
git diff main origin/main        # 내 main vs 원격 main 차이

4. 브랜치 보기와 정리 (삭제)

브랜치는 3 군데에 따로 살아 있어. 어디 있는 것을 지우는지 헷갈리지 않으려면 먼저 이 3 가지를 구분해야 해.

4-1. 보기 명령

# 출력 예시 — git branch -vv
* coworkServer  7dd9ec4 [origin/coworkServer] peer 목록 부트스트랩...
  design        b27efe4                       # 대괄호 없음 = upstream 없음
  main          f46d979 [origin/main]         스케줄 바 우측 상태 적용

4-2. 삭제 명령 — 3 가지 케이스

# PR이 GitHub에서 merge된 직후

git checkout main
git pull                              # merge된 내용 로컬로 가져옴

git branch -d coworkServer            # ① 로컬 작업 브랜치 정리
git push origin --delete coworkServer # ③ GitHub 브랜치도 정리 (선택)
git fetch --prune                     # ② 캐시 정리 — push --delete 했다면 보통 자동

git branch -d design
error: The branch 'design' is not fully merged.
If you are sure you want to delete it, run 'git branch -D design'.

# 1) 원격 변화를 정찰 + 사라진 브랜치의 캐시 청소
git fetch --prune

# 출력 예 — origin/coworkServer 가 사라졌음을 알려줌
#  - [deleted]      (none)     -> origin/coworkServer
#    f46d979..3ca4fa2  main     -> origin/main

# 2) main 으로 이동해서 merge 결과 받아오기
git checkout main
git pull

# 3) 로컬 작업 브랜치 삭제 (이미 merge됐으니 -d 가 안전 통과)
git branch -d coworkServer

* main    3ca4fa2 [origin/main] Merge pull request #1...
  design  b27efe4                                     # 무관한 다른 로컬 브랜치

5. 여러 브랜치 다루기 (협업 시작점)

혼자 쓸 때는 main 하나만 보다가, GitHub에 A_branch·B_branch 처럼 여러 브랜치가 있는 저장소를 받아오면 갑자기 헷갈리기 시작해. 이 섹션은 그 상황을 처음부터 끝까지 정리한 거야.

5-1. clone하면 무슨 일이 일어나나

가장 헷갈리는 지점부터. git clone은 모든 브랜치의 데이터를 받지만, 로컬 브랜치(①)는 기본 브랜치 하나만 만든다. 나머지는 원격 추적 참조(②)로만 존재해.

git clone https://github.com/내이름/프로젝트.git
cd 프로젝트
git branch                 # * main  ← 로컬은 main 하나뿐
git branch -r              # origin/main, origin/A_branch, origin/B_branch ← 원격은 다 보임
git branch -a              # 위 두 결과 합쳐서 한번에 확인

5-2. 특정 원격 브랜치로 작업하기

방법은 3가지인데 99%는 첫 번째.

방법 ① — 보통의 clone 후 그냥 checkout (가장 흔함)

git clone https://github.com/내이름/프로젝트.git
cd 프로젝트

git checkout A_branch        # 신버전: git switch A_branch
# 출력: "Switched to a new branch 'A_branch'"
#       "Branch 'A_branch' set up to track 'origin/A_branch'"

git branch -vv               # [origin/A_branch] 추적 확인

방법 ② — clone할 때부터 기본 브랜치를 지정

git clone --branch A_branch https://github.com/내이름/프로젝트.git
# 모든 브랜치 객체는 받지만, 처음 체크아웃이 A_branch가 됨

방법 ③ — 그 브랜치만 받기 (용량 절약)

git clone --single-branch --branch A_branch https://github.com/내이름/프로젝트.git
# origin/B_branch 등 다른 브랜치는 안 받음. 나중에 보고 싶으면:
git remote set-branches origin '*'
git fetch

5-3. 브랜치별 pull

핵심 규칙: git pull은 지금 체크아웃된 브랜치 하나만 갱신한다. A_branch와 B_branch를 둘 다 최신으로 만들고 싶으면 각각 들어가서 두 번 pull 해야 해.

# 둘 다 최신으로 만들기
git checkout A_branch
git pull                         # origin/A_branch → A_branch

git checkout B_branch
git pull                         # origin/B_branch → B_branch

git fetch                        # origin/* 전부 한꺼번에 갱신
git log A_branch..origin/A_branch  # 차이 보기
git log B_branch..origin/B_branch

5-4. 새 로컬 브랜치 → 새 원격 브랜치 (협업 시작점)

가장 자주 묻는 흐름. 로컬에서 C_branch_local 만들어 작업 → GitHub에 같은 이름의 브랜치로 push.

# 0) 시작은 어떤 브랜치든 상관없음 (보통 main)
git checkout main
git pull                              # main 최신화 (선택)

# 1) 새 브랜치 만들고 그 위로 이동 (한 번에)
git checkout -b C_branch_local        # 신버전: git switch -c C_branch_local
# 출력: "Switched to a new branch 'C_branch_local'"

# 2) 작업 → add → commit (평소처럼)
git add .
git commit -m "C 브랜치 작업 시작"

# 3) 첫 push — -u 옵션 잊지 말 것
git push -u origin C_branch_local
# GitHub에 'C_branch_local' 브랜치가 새로 만들어지고
# 로컬 C_branch_local ↔ origin/C_branch_local 추적까지 자동 연결됨

# 4) 이후엔 그냥
git push
git pull

5-5. 로컬·원격 이름이 다를 때

로컬에선 C_branch_local 인데 GitHub엔 C_branch_github 로 올리고 싶다면 로컬:원격 표기를 쓴다.

# 첫 push에서 이름 매핑
git push -u origin C_branch_local:C_branch_github

# 결과:
#   로컬:  C_branch_local *
#   원격:  C_branch_github  ← 추적
#   git branch -vv → C_branch_local [origin/C_branch_github]

# 이후엔 그냥 push/pull (추적 덕에 알아서 매핑)
git push
git pull

이미 push된 다음에 이름 바꾸기

# 1) 로컬 브랜치 이름 변경
git branch -m C_branch_local C_branch_new

# 2) 원격에 새 이름으로 push
git push -u origin C_branch_new

# 3) 옛 원격 브랜치 삭제
git push origin --delete C_branch_local

5-6. 작업 중 다른 브랜치로 잠깐 (stash)

C_branch_local 에서 작업 중인데 — 아직 commit하긴 어색하고 — 갑자기 main 의 급한 버그를 봐야 한다. 그냥 checkout main 하면 git이 막거나 작업이 따라와 버려. 이럴 때 stash.

# 1) 작업 중 변경을 임시 보관
git stash                          # 또는 git stash push -m "C 작업 도중"
git status                         # "nothing to commit, working tree clean"

# 2) 자유롭게 다른 브랜치로 이동, 작업, commit, push
git checkout main
# 긴급 수정 → add → commit → push

# 3) 돌아와서 보관함에서 꺼내 다시 적용
git checkout C_branch_local
git stash pop                      # 마지막 stash 적용 + 스택에서 제거
# 또는 git stash apply  ← 적용만 (스택에는 남음)

# 보관함 확인
git stash list                     # stash@{0}, stash@{1}, ...
git stash show -p stash@{0}        # 특정 stash 내용 보기

6. 한눈에 보는 요약