변경사항을 의미 단위로 나눠 커밋하기 (git add -p)

언제 사용하나

한 파일에 여러 목적의 변경이 섞였을 때, 리뷰하기 좋게 나눠 커밋할 때.

실행 전 확인

• git diff로 전체 변경을 훑어 어떤 묶음으로 나눌지 정한다.

명령

# 변경을 조각(hunk) 단위로 골라 스테이징
git add -p {{PATH}}
# y: 이 조각 추가, n: 제외, s: 더 잘게 나누기, q: 종료

# 스테이징된 것만 커밋
git commit -m "{{MESSAGE}}"

# 남은 변경으로 다음 커밋 반복
git add -p
git commit -m "{{NEXT_MESSAGE}}"

placeholder 설명

• {{PATH}} : 대상 파일/디렉터리 (생략 시 전체)
• {{MESSAGE}} : 이 커밋의 메시지

입력 예시

{{MESSAGE}} = "fix: 금액 반올림 오류 수정"

기대 결과

하나의 논리적 변경이 하나의 커밋으로 분리된다.

검증 방법

git log --oneline과 git show로 각 커밋이 한 가지 일만 하는지 확인한다.

주의사항과 흔한 실수

• git add .로 전부 담으면 목적이 섞여 리뷰가 어렵다.
• s(split)로도 안 나뉘면 e(edit)로 직접 조정할 수 있다.

관련 문서

• git add: https://git-scm.com/docs/git-add