GitHub 협업 실습 예시

1. GitHub 웹에서 빈 저장소 만들기

   오른쪽 위 + → New repository를 누릅니다. 이름을 적고, README·.gitignore·license는 체크하지 않은 채(빈 상태로) Create repository를 누릅니다. 다음 화면에 나오는 저장소 URL을 복사합니다.

2. 로컬에 원격 연결하기

   복사한 URL을 origin이라는 이름으로 등록합니다.

3. 연결 확인

   git remote -v로 origin이 제대로 잡혔는지 봅니다.

4. 첫 push로 업로드

   -u를 붙여 업스트림까지 설정합니다.

git remote add origin https://github.com/내계정/my-site.git
git remote -v                   # origin이 등록됐는지 확인
git push -u origin main         # 로컬 main을 원격 origin에 올림복사

1. 받을 위치로 이동

   프로젝트들을 모아 두는 폴더로 갑니다.

2. clone으로 통째로 복제

   URL 뒤의 이름으로 폴더가 새로 생깁니다.

3. 들어가서 origin 확인

   clone은 원격을 origin으로 자동 등록합니다.

cd ~/projects
git clone https://github.com/someone/cool-app.git
cd cool-app
git remote -v                   # origin이 자동으로 잡혀 있음복사

1. 변경을 로컬에 커밋

   먼저 로컬에 기록해야 올릴 거리가 생깁니다.

2. push로 원격에 반영

   업스트림이 설정돼 있으니 git push만으로 충분합니다.

3. GitHub 웹에서 확인

   저장소 페이지를 새로고침하면 방금 커밋이 보입니다.

git add index.html
git commit -m "메인 페이지 배너 문구 수정"
git push                        # 업스트림 설정돼 있으면 이거면 끝복사

1. 기능 브랜치 만들고 이동

   switch -c로 새 브랜치를 만들면서 그쪽으로 옮겨 갑니다.

2. 작업하고 커밋

   로그인 관련 변경을 이 브랜치에 쌓습니다.

3. 브랜치를 원격에 push

   새 브랜치라 -u로 업스트림을 잡아 줍니다.

4. GitHub 웹에서 PR 열기

   push 직후 저장소 페이지를 열면 노란 알림과 함께 Compare & pull request 버튼이 보입니다. 누른 뒤 base(합쳐질 대상, 보통 main)와 compare(내 브랜치)가 맞는지 확인합니다. 제목과 설명을 적고 Create pull request를 누릅니다.

git switch -c feature/login
# ... 로그인 기능 작업 ...
git add .
git commit -m "로그인 폼·세션 처리 추가"
git push -u origin feature/login복사

1. (원하면) 먼저 fetch로 받아만 두기

   fetch는 원격 변경을 가져만 오고 내 브랜치엔 합치지 않습니다. 무엇이 새로 왔는지 먼저 보고 싶을 때 씁니다.

2. pull로 받아서 합치기

   pull은 fetch + merge입니다. 받은 변경을 현재 브랜치에 바로 합칩니다.

3. 최신인지 확인

   log로 동료의 커밋이 들어왔는지 봅니다.

git fetch origin                # 받아만 둠(합치지 않음)
git log origin/main --oneline   # 새로 온 커밋 미리 보기
git pull                        # 받아서 현재 브랜치에 합침
git log --oneline -5복사

1. 저장소 루트에 README.md 작성

   제목·소개·실행법을 Markdown으로 적습니다.

2. 커밋하고 push

   로컬에 기록한 뒤 원격에 올립니다.

3. GitHub에서 확인

   저장소 첫 화면 아래에 README 내용이 렌더링돼 보입니다.

printf "# my-site\n\n바이브코딩으로 만든 간단한 소개 페이지.\n\n## 실행\n브라우저로 index.html 열기\n" > README.md
git add README.md
git commit -m "README 추가: 프로젝트 소개·실행법"
git push복사

1. GitHub 웹에서 병합

   PR 페이지 아래의 Merge pull request → Confirm merge를 누릅니다. 그러면 내 브랜치 변경이 base(main)에 합쳐집니다.

2. 원격 브랜치 삭제

   병합 직후 나타나는 Delete branch 버튼으로 더 이상 필요 없는 원격 기능 브랜치를 지웁니다.

3. 로컬을 최신 main으로 맞추기

   main으로 옮긴 뒤 pull로 방금 병합된 내용을 받습니다.

4. 로컬 기능 브랜치 삭제

   병합이 끝났으니 로컬에서도 지웁니다.

git switch main
git pull                        # 방금 병합된 변경을 로컬 main에 반영
git branch -d feature/login     # 다 쓴 로컬 브랜치 정리복사

1. 충돌 파일 확인

   status가 "both modified"로 충돌한 파일을 알려 줍니다.

2. 충돌 마커를 찾아 직접 정리

   편집기로 파일을 열면 <<<<<<< / ======= / >>>>>>> 마커가 보입니다. 위는 내 변경, 아래는 원격 변경입니다. 원하는 최종 모습으로 코드를 고치고 세 마커 줄을 모두 삭제합니다.

3. 해결한 파일을 add

   add는 "이 파일 충돌을 해결했다"는 표시입니다.

4. commit으로 병합 마무리

   커밋하면 합치기가 완료됩니다.

git pull                        # 여기서 CONFLICT 발생
git status                      # both modified: app.js 확인
# 편집기로 app.js 열어 마커(<<<<<<< ======= >>>>>>>) 정리·삭제
git add app.js
git commit -m "main 변경과 충돌 해결 (로그인 검증 통합)"복사