GitHub Pull Request 코드 리뷰 UI와 리뷰 흐름 정리

Pull Request(PR)는 단순한 코드 비교 화면이 아니라, 협업을 위한 공식적인 검토 공간입니다.
코드 리뷰의 핵심은 “변경된 부분을 정확히 보고, 필요한 피드백을 남기는 것”입니다.

 

1. Files changed 탭 이해하기

PR 페이지에서 Files changed(1번)를 클릭하면 변경된 파일과 코드 차이를 확인할 수 있습니다.

화면 구성은 다음과 같습니다.

• 왼쪽(2번): 변경된 파일 목록
• 중앙: 코드 변경 내역(diff)
  • 🔴 빨간색 → 삭제된 코드
  • 🟢 초록색 → 추가된 코드

즉, “무엇이 바뀌었는지”에만 집중할 수 있도록 설계된 화면입니다.

 

2. 라인 단위로 코멘트 남기기

코드 왼쪽 라인 번호 옆에 마우스를 올리면 + 버튼이 나타납니다.
이를 클릭하면 해당 줄에 직접 코멘트를 남길 수 있습니다.

 

3.  Add single comment vs Start a review

리뷰를 남기는 방식은 두 가지입니다.

• Add single comment
  → 즉시 공개되는 단일 코멘트
• Start a review
  → 여러 코멘트를 모아서 한 번에 제출
  → 제출 전까지는 Pending 상태 (다른 사람에게 보이지 않음)

코드를 전체적으로 검토한 뒤 정리해서 전달하고 싶다면
Start a review 방식이 더 적절합니다.

 

4. Review changes 버튼과 3가지 선택지

모든 코멘트 작성을 마친 후
우측 상단의 Review changes 버튼을 클릭하면 최종 리뷰를 제출할 수 있습니다.

 

선택지는 다음 세 가지입니다.

 

 1) Comment

개선 제안, 질문, 의견 전달
→ 병합에 직접적인 영향은 없음

 

 2) Approve

코드에 문제 없음을 승인
→ Branch protection rule이 있다면 필수 조건이 될 수 있음

 

 3) Request changes

수정이 필요하다는 공식 요청
→ 수정 전까지 Merge 불가
→ 작성자가 수정 후 새 커밋 push → 재리뷰 → Approve

5. 정리

GitHub 코드 리뷰는
“변경된 코드 확인 → 라인 단위 피드백 → 리뷰 방식 선택 → 최종 승인/수정 요청”
의 흐름으로 진행됩니다.

 

PR은 단순 코드 업로드가 아니라,
협업 품질을 높이기 위한 검토 프로세스입니다.

 

GitHub PR 리뷰는 Files changed에서 변경 코드를 확인하고,

라인 단위 피드백 후 Comment·Approve·Request changes로 최종 의사를 전달하는 구조입니다.