git add 실수 줄이기: -p로 변경사항 선택 스테이징하는 방법과 복구 팁

git add 실수 줄이기: -p로 변경사항 선택 스테이징하는 방법과 복구 팁

git add는 커밋 품질을 좌우한다. 특히 -p는 하나의 파일 안에서 필요한 변경만 선택해 커밋 단위를 깔끔하게 유지할 수 있다.

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

기본 사용법

git add src/api/user.ts
git add -A
git add -p

자주 쓰는 옵션 4가지

항목	의미	언제 쓰는지(실무 상황)
-A	전체 변경(추가/수정/삭제) 스테이징	작업 단위가 명확하고 전체 커밋이 필요할 때
-p	hunk 단위 인터랙티브 선택	리팩터링과 버그수정을 분리해 커밋할 때
-u	추적 중 파일의 수정/삭제만 추가	신규 파일 제외하고 핫픽스만 반영할 때
-N	의도만 먼저 기록(intent-to-add)	빈 파일 포함 구조를 미리 리뷰받고 싶을 때

문제 상황

상황: 디버그 코드와 핵심 수정이 한 커밋에 섞여 리뷰가 지연된다.
원인: add -A만 사용해 변경 단위를 분리하지 않았다.
해결: git add -p로 의미 단위로 나눠 커밋하고 필요 시 파일을 분할한다.
예방 팁: 작업 시작 전에 커밋 단위(기능/버그/정리)를 먼저 정의한다.

참고/출처

공식 문서: git-add manual
공식 문서: Pro Git - Interactive Staging
신뢰 자료: Atlassian - Saving changes