git diff 리뷰 품질 높이기: 커밋 전 변경 비교와 누락 점검 실무 방법

git diff 리뷰 품질 높이기: 커밋 전 변경 비교와 누락 점검 실무 방법

git diff는 코드리뷰 품질을 올리는 필수 명령어다. unstaged와 staged 차이를 이해하면 커밋 누락이나 과다 반영을 줄일 수 있다.

공식 Git 로고 (출처: git-scm.com)

기본 사용법

git diff
git diff --staged
git diff main...feature/login

자주 쓰는 옵션 4가지

항목	의미	언제 쓰는지(실무 상황)
--staged	스테이징된 변경만 비교	커밋 직전 최종 점검할 때
--name-only	파일명만 출력	영향 파일 목록을 빠르게 공유할 때
--word-diff	단어 단위 변경 강조	문서/쿼리 수정 차이를 명확히 볼 때
--stat	파일별 변경량 요약	PR 설명에 변경 규모를 포함할 때

문제 상황

상황: PR 머지 후 테스트 파일 누락으로 CI가 실패한다.
원인: staged diff를 확인하지 않아 일부 파일이 빠졌다.
해결: 커밋 전 git diff --staged와 --name-only를 함께 확인한다.
예방 팁: PR 템플릿에 diff 체크 항목을 고정해 누락을 줄인다.

참고/출처

공식 문서: git-diff manual
공식 문서: Pro Git - Advanced Merging
신뢰 자료: Atlassian - git diff