🔖 Git으로 협업 시작하기 #7 – PR 시 리뷰어 혼란 줄이는 Git 커밋 전략

🔹 15. 실수 없는 협업을 위한 커밋/PR 전략

 

📌 15-1. 커밋 단위를 작게, 논리적으로 구분

👉 하나의 커밋에는 하나의 목적만 포함되도록

 

✔️ 예 : "로그인 유효성 검증 추가" / "프론트 style 수정"은 별도 커밋으로

❌ "로그인 + 리팩토링 + style 수정"을 한꺼번에 올리는 건 리뷰 불가능하게 만듦

 

📌 15-2. git status, git diff 없이 커밋하지 않기
👉 커밋 전에 꼭 상태 확인

git status
git diff

→ PR에 불필요한 변경사항이나 삭제된 내용이 올라가는 걸 방지
→ .gitignore로 무시한 파일이 의도치 않게 영향 주는 것도 조기 확인 가능

---

📌 15-3. PR 설명은 리뷰어의 눈높이에 맞게 작성
👉 예시 :

🛠️ 기능 추가: 게시판 글 수정 기능
⚠️ 제외된 파일: application-local.yml (.gitignore 처리)
💬 리팩토링 내용은 별도 커밋으로 분리함

코드보다 설명이 더 큰 가치를 줄 수 있음
→ 리뷰 피로도 ↓, 신뢰도 ↑

---

📌 15-4. 커밋 메시지 규칙 지키기 (선택)
👉 협업 중이면 팀 내 커밋 컨벤션 도입 추천
예시 :

feat: 로그인 인증 처리 로직 구현
fix: 게시판 댓글 수정 시 NPE 발생 해결
refactor: 중복 로직 유틸 클래스로 분리

---

💡 요약 정리
1️⃣ 커밋은 작게, 목적별로 쪼개기
2️⃣ git status, git diff 필수 확인
3️⃣ PR에는 제외된 파일 및 주의사항을 반드시 명시
4️⃣ 팀 내 일관된 커밋 메시지 포맷 적용 권장