13강. Pull Request의 목적과 생성

?1. 이번 강의에서 해결할 문제

기능 브랜치를 바로 main에 합치면 변경 목적, 검증 방법, 논의 기록이 남기 어렵습니다. Pull Request로 비교 범위와 완료 조건을 명확히 제안합니다.

✓2. 학습 목표

✓이 강의를 마치면

• PR의 base와 compare 브랜치를 올바르게 선택합니다.
• 제목과 본문에 변경 이유와 검증 결과를 기록합니다.
• Draft와 ready for review 상태를 구분합니다.

◇3. 핵심 개념

Pull Request는 compare 브랜치의 커밋을 base 브랜치에 병합하자는 GitHub의 변경 제안입니다. 커밋 자체는 Git 데이터이고, 대화·리뷰·검사 결과는 GitHub에 기록됩니다. 작업 중이면 Draft PR로 조기에 공유할 수 있습니다.

§4. 단계별 명령어와 예시

브랜치: feature/profile-page / 대상: main

PowerShell

Set-Location C:\dev\git-learning-site
git switch feature/profile-page
git status
git log --oneline origin/main..HEAD
git diff --stat origin/main...HEAD
git push -u origin feature/profile-page

GitHub 저장소에서 Pull requests → New pull request로 이동하고 base를 main, compare를 feature/profile-page로 선택합니다. UI 문구가 바뀌면 GitHub 공식 “Creating a pull request” 문서의 현재 절차를 따릅니다.

PR 본문 예시

## 변경 내용
- 학습자 프로필 페이지 추가

## 확인 방법
- [ ] 링크가 열리는지 확인
- [ ] npm run build 통과

→5. 명령어가 동작하는 이유

origin/main..HEAD는 기능 브랜치에만 있는 커밋을 보여 줍니다. 세 점 diff는 두 브랜치의 공통 조상 이후 기능 브랜치가 만든 변경을 비교해 PR 범위와 가깝습니다. 원격에 브랜치가 있어야 GitHub가 비교할 수 있습니다.

!6. 자주 하는 실수와 안전한 해결법

!자주 하는 실수

• base와 compare를 반대로 선택: “어디로 합칠지”가 base입니다. 파일 변경 탭에서 범위를 확인합니다.
• 제목이 “수정”뿐임: 사용자가 얻는 결과를 제목에 씁니다.
• 미완성인데 일반 PR 생성: Draft로 만들고 완료 조건을 체크리스트로 남깁니다.

✎7. 직접 실습

✎직접 실습

1. 기능 브랜치를 원격에 push합니다.
2. 변경 내용, 이유, 확인 방법을 적은 Draft PR을 만듭니다.
3. Files changed에서 예상한 파일만 포함됐는지 확인합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. main에 기능을 합치려면 base와 compare는 각각 무엇인가요?
2. Draft PR이 유용한 시점은 언제인가요?
3. PR 생성 전에 로컬에서 비교 범위를 보는 두 명령은 무엇인가요?

■9. 핵심 요약

■핵심 요약

PR은 코드 묶음이 아니라 변경 이유, 범위, 검증을 함께 제안하는 검토 단위입니다. base와 compare를 확인하고 작은 범위로 설명합니다.