Git & GitHub 기본 사용 가이드 (일반적인 브랜치 & Git Workflow 방식 포함)

1. 프로젝트 폴더 생성 및 Git 초기화

먼저 터미널을 열고, 프로젝트를 저장할 디렉토리로 이동한 후 Git 버전 관리를 시작합니다.

git init

해당 폴더가 Git으로 관리되기 시작합니다.

2. 변경 사항 추적 및 커밋 저장

모든 변경사항 추적

git add .

특정 파일만 추적

git add 파일명

변경사항 저장 (커밋)

git commit -m "변경사항에 대한 간단한 설명"

3. 원격 저장소(GitHub) 연결 및 업로드

1. https://github.com 접속 → 로그인 후 New Repository 생성
2. Repository 주소 복사
3. 터미널에서 아래 명령어 입력

git remote add origin https://github.com/사용자명/저장소명.git

GitHub에 처음 업로드

git push -u origin main

4. 브랜치(Branch) 사용법

브랜치란? 독립적으로 작업할 수 있는 코드의 분기. (예: 기능 추가, 실험 등 main에 영향을 주지 않고 작업 가능)

 

브랜치 만들기

git branch 브랜치이름

 

예시:

git branch feature/1 <- 저희 같은경우 이런식으로 어떤 이슈인지 이슈번호가 몇번인지 브랜치를 생성하기로 했습니다

 

브랜치 이동

git checkout 브랜치이름

 

또는 최신 버전에서는:

git switch 브랜치이름

예시:

git switch feature/1

 

브랜치 생성 + 이동을 한 번에

git checkout -b 브랜치이름

또는:

git switch -c 브랜치이름

 

현재 브랜치 확인

git branch

 

현재 브랜치 앞에는 * 표시가 있습니다.

 

작업 후 커밋

git add .
git commit -m "브랜치에서 작업한 내용"

 

인텔리제이 기능 활용하는 방법

5. 브랜치 병합하기 (Merge)

작업이 끝난 브랜치를 main에 반영할 수 있습니다.

1. main 브랜치로 이동

git switch main
git checkout main

1. 작업 브랜치 병합

git merge 브랜치이름

예시:

git merge feature/1

6. GitHub에서 브랜치 작업 올리기

git push origin 브랜치이름

 

예시:

git push origin feature/1

 

GitHub에서 Pull Request를 생성해 병합할 수 있습니다. (저희가 사용할 방식 이유는 코드 리뷰를 위해)

7. GitHub의 최신 내용 받아오기

git pull origin develop

 

브랜치를 병합하거나 다른 작업자가 push한 내용 반영 시 사용합니다.

저 조 같은 경우 git flow 회의때 develop에 작업사항을 병합후 다 완성한뒤 (실제로는 배포단계)에서 main에 병합하기로 결정 했기때문에 develop을 해주시면 되며 다른 프로젝트에서는 병합하고 있는 브랜치로 변경해주셔야 합니다.

8. 우리가 사용하는 워크플로우 방식

 

GitHub Issues와 연동한 자동 브랜치 생성

1단계: 이슈 생성

• GitHub 저장소에서 Issues 탭으로 이동
• New Issue 클릭하여 이슈 템플릿을 따라 작업할 내용 작성
• 이슈 번호가 자동으로 생성됨 (예: #1)

2단계: 이슈 기반 브랜치 자동 생성

• 브랜치명이 자동으로 생성됨 (예: feature/1)

3단계: 로컬에서 최신 상태 동기화

git fetch origin

4단계: 원격 브랜치 정보 확인

git branch -r

 

5단계: 생성된 브랜치로 이동

git switch feature/1
OR
git checkout feature/1

 

 

6단계: 작업 진행

• 코드 수정 및 작업 진행
• 변경사항 추가 및 커밋

git add .
git commit -m "fix: 로그인 버그 수정 #123"

 

7단계: 작업 완료 후 푸시

git push origin feature/1

 

8단계: Pull Request 생성

• GitHub에서 자동으로 Pull Request 생성 알림이 표시됨Pull Request 생성 시 이슈와 자동 연결됨
• 이슈 템플릿을 따라 작성후 "close #1 이런식으로 제일 아래부분에 이슈 번호와 함께 작성"
• 병합 완료 시 이슈가 자동으로 닫힘
• 조금 기다리면 나오는 브랜치 삭제 버튼 누르시면 브랜치도 자동으로 삭제됩니다.

브랜치 네이밍 규칙 예시

저희는 자동 생성 기능을 사용하지 않았지만 원래는 컨벤션 회의에서 

git flow를 회의할때 결정합니다.

주요 Git 명령어 비교

명령어 기능 사용 예시

git fetch	원격 저장소의 최신 정보만 가져오기	예시	git fetch origin
git pull	원격 저장소의 변경사항을 가져와서 병합	예시	git pull origin develop
git checkout	브랜치 이동 (구버전)	예시	git checkout feature/1
git switch	브랜치 이동 (신버전)	예시	git switch feature/1

정리

작업 명령어

Git 초기화	git init
파일 추가	git add .  → 전체 변경사항 스테이지에 올림 git add 파일명 → 원하는 파일만 선택해서 올림
커밋 저장	git commit -m "커밋메시지"
원격 연결	git remote add origin URL
업로드	git push -u origin main
브랜치 생성	git branch 이름 or git switch -c 이름                              git checkout -b 이름
브랜치 이동	git switch 이름 git checkout 이름
브랜치 병합	git merge 이름
최신 정보 가져오기	git fetch origin
최신 병합 내용 가져오기	git pull origin main ( 디폴트 브랜치)