[ Git ] GitHub 협업 준비과정

GitHub는 전 세계 개발자들이 코드 협업을 위해 사용하는 필수 도구입니다.
이 글에서는 GitHub 설치 및 계정생성을 제외한 GitHub 협업을 준비하는 과정을 설명합니다.
초보자도 쉽게 따라 할 수 있도록 자세히 정리했으니, 협업 환경을 만들어보자!! 😊

---

GitHub에서 협업을 준비하는 방법

Step 1. 프로젝트 클론

리포지토리를 로컬로 복사(clone)하여 작업을 시작합니다.

git clone <리포지토리 URL>

 

예시

git clone https://github.com/username/MyProject.git

 

---

Step 2. 브랜치 전략 수립

Git 브랜치를 사용하면 서로 간섭 없이 작업할 수 있습니다.

저의 경우 아래와 같이 진행하였습니다.

 

🌿 Git 브랜치 전략

브랜치 구조

main	배포 가능한 안정된 코드만 포함합니다.
develop	모든 새로운 기능이 병합되기 전 상태입니다.
feature/기능명	기능 개발 브랜치 (예: feature/login-page)
bugfix/버그명	버그 수정 브랜치 (예: bugfix/crash-fix)

브랜치 생성 명령어

git checkout -b develop
git push -u origin develop

 

git checkout -b feature/( 예시 ) login_Page develop

 

---

Step 3. 코드 작성 및 변경 사항 관리

1. 코드 작성

Xcode에서 코드를 작성하거나 파일을 추가합니다

// ViewController.swift
import UIKit

class ViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        print("Hello, GitHub!")
    }
}

 

2. 변경 사항 확인

git status

 

3. 변경 사항 스테이징 및 커밋

git add .
git commit -m "feat: Add basic ViewController setup"

 

4. 변경 사항 푸시

git push origin feature/login

 

---

Step 4. Pull Request 생성

Pull Request(PR)는 작업 내용을 검토하고 병합하는 과정입니다.

 

GitHub에서 Pull Request 생성

1. Pull Requests 탭 클릭 → New Pull Request.
2. Base 브랜치: develop, Compare 브랜치: feature/login 선택
3. PR 제목과 설명 작성
   
   • 제목 예시 ) [Feat] Add LoginView
   • 설명 예시 ) 저의 경우 아래와 같이 규칙을 세워서 진행하였습니다.
4. 팀원에게 코드 리뷰를 요청합니다. ( 팀원이 없을 시 체크리스트를 지켰는지 더블체크 )

✅ Pull Request 규칙
PR 제목
[Feat] Add user registration feature
[Fix] Resolve crash on profile page
PR 설명
주요 변경사항 및 테스트 방법을 상세히 작성합니다.
체크리스트
[ ] 코드 스타일 준수
[ ] 테스트 코드 작성
[ ] 기존 기능과의 호환성 확인

 

---

Step 5. Pull Request 이후 과정

1.  팀원 리뷰

 

1. 팀원이 PR 내용을 검토하고 의견을 남깁니다.
2. 리뷰에서 요청된 변경 사항이 있다면, 브랜치에서 수정 후 커밋 & 푸시
3. 변경 사항은 PR에 자동으로 반영됩니다.

git add .
git commit -m "fix: Adjust LoginView text alignment"
git push origin feature/login-page

 

 

2. 병합

 

1. PR 페이지에서 Merge Pull Request 버튼 클릭.
2. 병합 후, 원격 브랜치 정리

 

git branch -d feature/login-page
git push origin --delete feature/login-page

---

협업을 위한 팁 

 

• 커밋 메시지 규칙
  • [Feat]: 새로운 기능 추가.
  • [Fix]: 버그 수정.
  • [Refactor]: 코드 리팩터링.
  • [Docs]: 문서 추가/수정.
• 코드 리뷰 요청
  • PR 설명에 변경된 파일과 테스트 방법을 상세히 작성.
• .gitignore 파일 활용
  • Git에서 추적하지 않을 파일을 지정

.DS_Store
Pods/
*.log