GitHub는 개발자들이 함께 소스코드를 관리하고 협력하는 강력한 도구입니다. 특히 오픈소스 프로젝트에 참여하거나 팀 프로젝트를 진행할 때 자주 사용하는 중요한 기능 중 하나가 바로 Pull Request(PR)입니다. 본 글에서는 GitHub를 처음 접하는 초심자도 쉽게 따라할 수 있도록 PR을 작성하는 방법을 상세히 안내합니다.
Pull Request(PR)란?
Pull Request는 내가 수정하거나 추가한 내용을 원본 저장소에 병합(merge) 요청하는 기능입니다. PR을 통해 변경 사항을 다른 개발자와 공유하고, 코드 리뷰 및 의견 교환을 할 수 있습니다.
1단계: 저장소 Fork 하기
Fork는 원본 저장소를 나의 GitHub 계정으로 복제하는 과정입니다.
방법:
- GitHub에서 참여하려는 프로젝트의 저장소를 찾아 들어갑니다.
- 화면 우측 상단의 Fork 버튼을 클릭합니다.
- Fork가 완료되면 나의 계정에 프로젝트가 복제된 것을 확인할 수 있습니다.
2단계: 로컬로 복제(Clone)하기
Fork한 저장소를 로컬 컴퓨터로 다운로드하여 작업할 준비를 합니다.
방법:
터미널(명령 프롬프트 또는 Git Bash)을 실행하고 아래 명령어를 입력합니다.
git clone [Fork된 저장소의 URL]예시:
git clone https://github.com/your-username/project-name.git3단계: 브랜치 만들기 및 작업하기
새로운 기능이나 수정사항은 별도의 브랜치를 만들어서 작업합니다.
방법:
새 브랜치를 만들고 이동합니다.
git checkout -b feature/new-feature-name이제 새 브랜치에서 원하는 작업을 수행합니다.
4단계: 변경 사항 커밋 및 푸시하기
로컬에서 작업한 내용을 저장소에 반영하기 위해 커밋(commit)한 후 GitHub에 푸시(push)합니다.
방법:
변경된 파일 추가:
git add .변경 사항 확인:
git status커밋 메시지 작성(명확하게 작성 권장):
git commit -m "기능 추가: 상세한 커밋 메시지 작성"GitHub 저장소에 푸시:
git push origin feature/new-feature-name5단계: GitHub에서 Pull Request 생성하기
이제 GitHub 웹사이트에서 PR을 생성합니다.
방법:
- 본인의 Fork된 저장소에 접속하고, 방금 푸시한 브랜치를 선택합니다.
- Compare & pull request 버튼을 클릭합니다.
- PR 제목과 상세 설명을 작성합니다.
- 예시 제목: "기능 추가: 사용자 로그인 기능 구현"
- 설명: 변경 사항에 대한 구체적인 설명 및 배경을 포함합니다.
- 마지막으로 Create pull request 버튼을 눌러 PR을 최종적으로 제출합니다.
6단계: 코드 리뷰 및 병합(Merge)
PR을 제출하면 프로젝트 관리자나 다른 팀원이 코드를 검토(리뷰)하게 됩니다.
- 리뷰어의 의견에 따라 코드 수정 요청이 있을 수 있습니다.
- 수정 요청을 받으면 다시 작업하여 커밋 및 푸시를 하면 PR이 자동으로 업데이트됩니다.
- 최종적으로 승인(Approve) 후 병합(Merge)이 이루어지면 작업이 완료됩니다.
참고 링크
이제 여러분도 자신 있게 GitHub에서 PR을 만들어 보세요!
C#, .Net 개발자입니다.