팀 협업의 흐름#
Diagram · Mermaid
Feature Branch 워크플로우#
팀에서 가장 많이 쓰는 방식입니다.
Bash
# 1. 최신 main을 받아옴
git switch main
git pull origin main
# 2. 기능 브랜치 생성
git switch -c feature/user-profile
# 3. 작업 및 커밋
git add .
git commit -m "feat: 사용자 프로필 페이지 추가"
# 4. 원격에 push
git push -u origin feature/user-profile
# 5. GitHub에서 Pull Request 생성Pull Request 만들기#
GitHub에서 브랜치를 push하면 "Compare & pull request" 버튼이 나타납니다.
좋은 PR 작성법#
Markdown
## 변경 사항
- 사용자 프로필 페이지 추가
- 아바타 이미지 업로드 기능
- 프로필 수정 폼
## 테스트 방법
1. /profile 페이지 접속
2. 이미지 업로드 테스트
3. 폼 저장 확인
## 스크린샷
(이미지 첨부)
## 관련 이슈
Closes #42코드 리뷰#
Diagram · Mermaid
리뷰 댓글 반영#
Bash
# 리뷰 피드백 수정 후
git add .
git commit -m "fix: 리뷰 피드백 반영 — 에러 처리 추가"
git push
# PR에 자동으로 새 커밋이 반영됨Fork: 오픈소스 기여#
남의 저장소에 직접 push 권한이 없을 때 사용합니다.
Diagram · Mermaid
Bash
# 1. GitHub에서 Fork 클릭
# 2. 내 Fork를 clone
git clone https://github.com/my-username/original-project.git
cd original-project
# 3. 원본 저장소를 upstream으로 등록
git remote add upstream https://github.com/original-owner/original-project.git
# 4. 작업 후 내 Fork에 push
git push origin feature/my-fix
# 5. 원본 저장소로 PR 생성 (GitHub에서)
# 6. 원본 저장소 최신화 동기화
git fetch upstream
git merge upstream/mainIssue 연동#
Bash
# 커밋 메시지에 이슈 번호를 포함하면 자동 연결
git commit -m "fix: 로그인 버그 수정 (#42)"
# PR 병합 시 이슈 자동 닫기
# PR 본문에 이렇게 작성:
# Closes #42
# Fixes #42
# Resolves #42브랜치 보호 설정 (GitHub)#
Settings → Branches → Add rule에서:
Require a pull request before merging: PR 없이 직접 push 금지Require approvals: 최소 N명 승인 필요Require status checks: CI 통과 필수
정리#
| 개념 | 설명 |
|---|---|
| Feature Branch | 기능별 독립 브랜치 → PR → Merge |
| Pull Request | 변경사항 제안 + 코드 리뷰 |
| Fork | 타인 저장소 복사 → 오픈소스 기여 |
| upstream | Fork의 원본 저장소 |
| 브랜치 보호 | main 직접 push 방지 |
다음 편에서는 고급 기능 — stash, rebase, cherry-pick, 되돌리기 등 실무에서 자주 쓰는 기법을 배웁니다.
