git apply: 커밋 없이 작업 트리에만 패치 적용하기

지난 글에서 패치 파일을 작성자 정보까지 담은 커밋으로 되살리는 git am을 살펴봤습니다. 그런데 항상 커밋까지 만들어야 하는 것은 아닙니다. 변경 내용만 일단 내 작업 트리에 얹어 보고, 커밋은 내 손으로 정리하고 싶을 때가 있습니다. 이럴 때 쓰는 더 가벼운 도구가 git apply입니다.

git apply vs git am

두 명령은 모두 패치를 적용하지만 결정적으로 다릅니다. git am이 커밋을 만드는 데 반해, git apply는 파일만 바꿉니다. 작성자·날짜·커밋 메시지를 다루지 않고, 순수한 코드 변경(diff)만 작업 트리에 반영합니다.

그래서 git apply는 메일박스 헤더가 없는 순수 diff 파일에 잘 맞습니다. git diff > change.diff로 만든 파일이나, 코드 리뷰 도구가 내려준 diff 조각을 적용할 때 자연스럽습니다.

# 순수 diff 패치를 작업 트리에 적용
git apply change.diff

적용 후 git status를 보면 변경된 파일이 수정 상태로 나타날 뿐, 새 커밋은 없습니다. 어떻게 커밋으로 묶을지는 전적으로 내 몫입니다.

적용 전에 안전하게 확인하기

git apply는 패치가 깔끔하게 들어맞지 않으면 아무것도 적용하지 않고 실패합니다. 그래서 본 적용 전에 미리 점검하는 옵션이 유용합니다.

# 적용 가능한지만 검사 (파일은 건드리지 않음)
git apply --check change.diff

# 어떤 파일이 얼마나 바뀌는지 요약만 출력
git apply --stat change.diff

--check는 “이 패치가 지금 코드에 깨끗하게 적용되는가”를 미리 알려 주므로, 자동화 스크립트에서 적용 가능 여부를 판단할 때 특히 유용합니다. --stat은 실제 적용 없이 변경 규모만 미리 보여 줍니다.

충돌과 스테이징 제어

패치가 현재 코드와 어긋날 때는 --3way로 3-방향 병합을 시도할 수 있습니다.

# 충돌 시 공통 조상을 활용해 병합 시도
git apply --3way change.diff

# 작업 트리뿐 아니라 스테이징 영역에도 함께 적용
git apply --index change.diff

# 스테이징 영역에만 적용 (작업 트리는 그대로)
git apply --cached change.diff

--3way는 단순 매칭이 실패해도 충돌 마커를 남기며 최대한 병합해 줍니다. --index는 적용과 동시에 git add까지 한 효과를 내고, --cached는 인덱스만 바꿔 부분 스테이징 같은 정교한 조작에 쓰입니다.

적용한 패치 되돌리기

이미 적용한 패치를 거꾸로 되돌리려면 -R(reverse)을 씁니다.

# 방금 적용한 패치를 역으로 취소
git apply -R change.diff

패치를 적용했다가 문제가 생겼을 때, 같은 파일에 -R을 붙여 다시 실행하면 변경이 깔끔하게 사라집니다. patch -p1 < change.diff 같은 전통적 도구와 비슷하지만, git이 경로와 컨텍스트를 더 똑똑하게 처리한다는 장점이 있습니다.

언제 무엇을 쓰나

정리하면 선택 기준은 명확합니다. 커밋 정보(작성자·메시지)를 보존하며 커밋까지 만들고 싶다면 git am, 변경 내용만 작업 트리에 얹고 커밋은 직접 구성하고 싶다면 git apply입니다. 코드 리뷰 중 받은 diff를 잠깐 적용해 확인하거나, CI 스크립트에서 패치 적용 가능성만 검사하는 상황이라면 git apply가 훨씬 가볍고 적합합니다.

정리

git apply는 커밋을 만들지 않고 diff를 작업 트리에 입히는 도구입니다. --check로 적용 가능성을 미리 확인하고, --stat으로 규모를 살피며, --3way로 충돌을 완화하고, --index/--cached로 스테이징을 제어하며, -R로 되돌립니다. 다음 글에서는 흩어진 작성자 신원을 출력 단계에서 하나로 묶어 주는 .mailmap을 살펴봅니다.

---

지난 글: git am: 메일박스 패치를 커밋으로 되살리기

다음 글: git mailmap: 흩어진 작성자 신원을 하나로 통합하기

읽어주셔서 감사합니다. 😊