GitHub에 있는 Repo로 Local Repo 초기 셋업 하는 가이드 (for 팀원들)

nara_lee·2025년 5월 26일
0

💡도선이에게 따로 Note

  • github에서 타 팀원들이 잘못된 branch 위에서 작업할 가능성 있어서 현재 (5/26 9:30pm기준) doseon github branch에 있는 파일들 (backend, frontend repo 둘 다) 모두 내 local에 백업하고 main에다 merge도 하고 지운 상태.
    • step1. git fetch+ git pull 해서 최신 변화를 github에서 local git으로 반영해줘야함. (fetch와 pull 의 차이가 궁금하다면? 링크 참고)
    • step2. 위에서 fetch랑 pull 했음에도 도선의 local 환경에는 doseon이라는 branch가 여전히 남아 있을 것임. (github branch랑 local git branch랑은 엄밀히 말하면 따로 관리 되는 것이기 때문.) 이걸 지워줘야 함. git branch -D doseon
    • step3. 아래 2번 branch checkout 하는데부터 따라하면 됨.
  • 귀찮으면 local 에 있는 폴더 아예 싹 지우고 아래 step대로 처음부터 따라하는 것을 추천

1. Git Clone: Remote (GitHub) Repository 가져오기

Option1 (추천): Github Desktop 에서 Clone Repository

Github Desktop 앱 다운: 🔗🔗🔗


⚠️ 주의: 여기서 Local Path “Choose…” 눌러서 local 어디에 repo 만들건지 확인 요망

이제 너가 방금 만든 local repo (로컬 폴더를) IDE (cursor, VScode 등)으로 열면 됨

Option2: 터미널에서 하는 법

이 문서 참조: 🔗🔗🔗

초록색 "<Code>" 버튼 눌러서 하는거 알지? 이때 화면에 띄워져 있는 브랜치가 뭔지는 상관 없음 (e.g. “main”, “doseon2”)

2. 내가 작업할 브랜치를 올바르게 설정하기


VS Code는 좌측 하단에 current working branch가 표시됨 (”current working branch” = 내가 지금 작업하고 있는 브랜치)

  • Step1. git branch 명령어로 IDE terminal 에서 지금 보고 있는 브랜치 확인
    스크린샷에 보면 맨 처음에는 “doseon2” 로 되어 있음.

  • Step2. git checkout main 명령어로 main branch로 current working branch 를 변경

  • Step3. git branch *너가정한브랜치이름* 명령어로 지금 최신 main에서 너의 branch 파생하기. (단 이때 파생한 branch는 local git에서만 생김.)

⚠️ 여기서 주의할 점은 git branch *너가정한브랜치이름 하고 바로 다음에 **git branch 로 current working branch 를 확인했을 때 자동으로 새로 생성한 branch로 current working branch 가 바뀌지 않았음을 확인할 수 있음. 그러니 다시 한번 checkout 명령어 (`git checkout 너가정한브랜치이름`)* 로 너가 생성한 브랜치로 들어가서 작업 시작해야함

3. 열심히 너가 생성한 브랜치에서 작업

틈틈히 git addgit commit으로 작업 안날라가게 해주는 것 잊지 않기


++ GitHub Desktop 있으면 commit도 terminal 로 안하고 아래 사진과 같이 GitHub Desktop으로 편하게 git commit도 할 수 있음 (상단에 ”Current Branch” 확인요망).

4. 로컬 브랜치에서 작업한 것을 github에 올리기

Option1 (추천): Github Desktop 에서 하는 법

  • 그냥 간단하게 “Publish branch”누르면 알아서 해줌. 자동으로 너가 새로 로컬에서 생성한 브랜치랑 연결된 github remote repo branch 가 생성해줌. (github가서 생겼나 안생겼나 확인해보면 생성된 걸 볼 수 있음.)

  • Branch 올라간 뒤로는 Push origin도 아래와 같이 손 쉽게 할 수 있음.

Option2: 터미널에서 하는 법


원문: https://www.freecodecamp.org/korean/news/git-push-to-remote-branch/

한마디로 그냥 git push 만 하면 디폴트로 git push origin 지금작업중인로컬브랜치 가 된다는 말임.

여기서 origin은 clone 할 때 우리 github 리포로 이미 등록되었기 때문에 신경 안써도 됨.

하지만 지금작업중인로컬브랜치 는 git branch 명령어로 더블체크를 하던가 본인이 작업했던 브랜치 이름을 명시 해주는 것이 안전함.


본 후기는 [한글과컴퓨터x한국생산성본부x스나이퍼팩토리] 한컴 AI 아카데미 (B-log) 리뷰로 작성 되었습니다.

#한컴AI아카데미 #AI개발자 #AI개발자교육 #한글과컴퓨터 #한국생산성본부 #스나이퍼팩토리 #부트캠프 #AI전문가양성 #개발자교육 #개발자취업

0개의 댓글