Git에서 파일 변경 사항의 일부만 커밋하는 방법

git add -p 사용하기

git add -p 명령어는 파일의 변경된 부분(hunk)을 하나씩 검토하며 커밋할지 여부를 선택하게 해줍니다. 이 방식은 커밋 히스토리를 깔끔하게 유지하고 싶을 때 유용합니다.

사용 방법:

1. git status 명령어로 변경된 파일 확인
2. git add -p 명령어 입력
3. 각 hunk에 대해 다음과 같은 옵션 선택
   • y: 커밋 스테이징 영역에 추가
   • n: 스킵
   • s: hunk 분할
   • ?: 도움말
4. git commit 명령어로 커밋 완료

예시:

$ git add -p
diff --git a/test.txt b/test.txt
hunk 1
@@ -1,3 +1,4 @@
-line 1
+new line 1
+new line 2
+line 3

위 예시에서는 new line 1과 new line 2만 커밋하고 line 3은 스킵합니다.

장점:

• 커밋 히스토리가 깔끔함
• 원하는 변경 사항만 정확하게 커밋 가능

단점:

• 여러 hunk를 선택해야 번거로울 수 있음

인터랙티브 커밋 에디터 사용하기

인터랙티브 커밋 에디터는 커밋 메시지를 작성하는 과정에서 변경된 파일을 편집할 수 있도록 도와줍니다. 이 방식은 여러 파일의 변경 사항을 한 번에 처리할 때 유용합니다.

1. 커밋 에디터에서 원하는 변경 사항 선택
   • 각 hunk 옆에 있는 '+' 또는 '-' 기호를 사용하여 커밋 여부 선택
   • 's' 키를 사용하여 hunk 분할
2. 커밋 메시지 작성 및 저장

$ git commit
... (커밋 에디터 실행)
pick 1st hunk
pick 2nd hunk
...

위 예시에서는 1번째와 2번째 hunk만 커밋하고 나머지 hunk는 스킵합니다.

• 여러 파일의 변경 사항을 한 번에 처리 가능
• 직관적인 인터페이스

• git add -p만큼 정확하게 제어하기 어려울 수 있음

기타 방법

위의 두 방법 외에도 다음과 같은 방법으로 파일 변경 사항의 일부만 커밋할 수 있습니다.

• git checkout -- <파일명>: 커밋 이전 버전으로 특정 파일 복원
• git reset HEAD^ <파일명>: 커밋 이전 버전으로 특정 파일 복원 및 스테이징 영역에서 제거
• 스크립트 사용: 복잡한 커밋 작업을 자동화

선택 가이드:

• 변경 사항이 단순하고 hunk 수가 적을 경우: git add -p 사용
• 변경 사항이 복잡하거나 여러 파일을 동시에 처리해야 할 경우: 인터랙티브 커밋 에디터 사용
• 특정 파일을 이전 버전으로 복원해야 할 경우: git checkout -- 또는 git reset HEAD^ 사용
• 복잡한 커밋 작업을 자동화해야 할 경우: 스크립트 사용

예제 코드

git add -p 사용하기

$ git add -p
diff --git a/test.txt b/test.txt
hunk 1
@@ -1,3 +1,4 @@
-line 1
+new line 1
+new line 2
+line 3

? y n s

y n s

인터랙티브 커밋 에디터 사용하기

$ git commit
... (커밋 에디터 실행)
pick 1st hunk
pick 2nd hunk
...

pick 1st hunk
pick 2nd hunk

참고:

• 커밋 에디터에서 hunk를 분할하려면 s 키를 누릅니다.
• 커밋 메시지를 작성 및 저장하려면 Ctrl+O, Enter, Ctrl+X를 차례대로 누릅니다.

Git에서 파일 변경 사항의 일부만 커밋하는 대체 방법

git rebase -i 사용하기:

• 이전 커밋을 수정하고 싶을 때 유용합니다.
• 여러 커밋을 하나로 병합하거나 분할할 수도 있습니다.

1. git rebase -i <base-commit> 명령어 입력 (예: git rebase -i HEAD~2)
2. 커밋 목록이 편집기에서 열림
3. 각 커밋 앞에 있는 문자를 변경하여 원하는 작업 선택
   • pick: 커밋 그대로 유지
   • edit: 커밋 메시지 편집
   • squash: 이전 커밋과 병합
   • reword: 커밋 메시지만 변경
   • drop: 커밋 삭제
4. 변경 내용 저장 후 커밋 에디터 종료
5. git rebase --continue 명령어로 변경 사항 적용

pick commit 1
pick commit 2
squash commit 3  # commit 3을 commit 2에 병합
pick commit 4

위 예시에서는 commit 3을 commit 2에 병합하고 나머지 커밋은 그대로 유지합니다.

• 이전 커밋을 편리하게 수정 가능
• 관련성 없는 커밋을 삭제하여 히스토리를 깔끔하게 유지 가능

• 잘못 사용하면 커밋 히스토리가 손상될 수 있음
• git push -f 명령어를 사용하여 변경 사항을 원격 저장소에 전파해야 함 (주의: 위험할 수 있음)

특수 도구 사용하기:

• 여러 파일의 변경 사항을 빠르고 쉽게 처리하고 싶을 때 유용합니다.
• 시각적 도구를 사용하여 hunk를 선택할 수도 있습니다.

예시 도구:

• gVim: vim 편집기의 강력한 플러그인
• The Silver Searcher: 파일 내용을 빠르고 효율적으로 검색 및置換할 수 있는 도구
• DeltaWalker: Git 커밋을 시각적으로 비교하고 병합하는 도구

• 작업 속도 향상
• 복잡한 커밋 작업을 간편하게 수행 가능

• 새로운 도구를 배우는 데 시간이 필요할 수 있음
• 모든 플랫폼에서 사용 가능한 것은 아님

주의 사항:

• 위에 소개된 방법들은 주의해서 사용해야 합니다. 특히 git rebase -i는 잘못 사용하면 커밋 히스토리를 손상시킬 수 있으므로, 숙련된 사용자만 사용하는 것이 좋습니다.
• 또한, 중요한 작업을 수행하기 전에 항상 백업을 취하도록 하십시오.

적합한 방법 선택:

• 상황에 따라 가장 적합한 방법을 선택하는 것이 중요합니다.
• 간단한 커밋만 필요한 경우 git add -p를 사용하는 것이 가장 쉽습니다.
• 이전 커밋을 수정해야 하는 경우 git rebase -i를 사용하는 것이 좋습니다.
• 여러 파일의 변경 사항을 빠르게 처리해야 하는 경우 특수 도구를 사용하는 것이 도움이 될 수 있습니다.