개발자라면 누구나 한 번쯤 겪는 상황이 있습니다. 밤늦게까지 코드를 작성하고 기분 좋게 커밋을 완료했는데, 엔터키를 누르는 순간 오타를 발견하거나 중요한 설정 파일을 포함하지 않았다는 사실을 깨닫는 순간입니다. 이때 당황해서 무작정 reset 명령어를 사용해 이전 상태로 되돌리려는 분들이 많습니다. 하지만 reset은 자칫하면 작업 중이던 스테이징 영역의 변경 사항을 섞이게 만들거나, 이력을 복잡하게 만들 수 있는 위험이 있습니다.
깃(Git)은 이러한 실수를 우아하고 깔끔하게 수정할 수 있는 강력한 도구들을 제공합니다. 바로 amend와 rebase입니다. 이 두 가지 기능을 적재적소에 활용하면, 마치 실수가 없었던 것처럼 커밋 히스토리를 정갈하게 유지할 수 있습니다. 특히 협업 환경에서 깔끔한 커밋 로그는 동료에 대한 배려이자 프로젝트의 품질을 높이는 중요한 요소가 됩니다. 오늘은 reset 없이도 안전하고 스마트하게 커밋을 수정하는 방법, 그리고 과거의 이력까지 자유자재로 다루는 심화 기술에 대해 아주 상세하게 알아보겠습니다.
가장 최근 커밋을 감쪽같이 수정하는 방법: git commit --amend
방금 막 커밋을 완료했는데 메시지에 오타가 있거나, 파일 하나를 깜빡하고 add 하지 않았을 때 가장 유용한 명령어가 바로 amend입니다. 'Amend'는 '수정하다'라는 뜻을 가지고 있으며, 말 그대로 가장 최근의 커밋을 덮어쓰는 방식으로 동작합니다. 새로운 커밋을 하나 더 쌓는 것이 아니라, 기존의 커밋을 대체하기 때문에 히스토리가 지저분해지지 않습니다.
단순한 커밋 메시지 오타 수정하기
커밋 메시지는 코드의 변경 사항을 설명하는 중요한 문서입니다. 하지만 'fix: bug fix'라고 적어야 할 것을 'fix: bug fux'라고 적었다면 꽤나 민망한 상황이 될 수 있습니다. 이때 reset --soft를 사용해 커밋을 취소하고 다시 작성하는 것은 번거롭습니다. 이때는 추가적인 작업 없이 바로 amend 옵션을 사용하면 됩니다.
터미널에서 git commit --amend 명령어를 입력하면, 텍스트 에디터가 열리면서 방금 작성했던 커밋 메시지가 나타납니다. 여기서 오타를 수정하고 저장한 뒤 에디터를 종료하면, 이전 커밋은 사라지고 수정된 메시지를 담은 새로운 커밋이 그 자리를 대체하게 됩니다. 만약 에디터를 열지 않고 명령어 한 줄로 빠르게 처리하고 싶다면 -m 옵션을 함께 사용하여 메시지를 바로 덮어쓸 수도 있습니다. 이 과정은 매우 직관적이며 작업 흐름을 끊지 않습니다.
주의할 점: amend를 사용하면 커밋의 내용은 같더라도 커밋의 고유 ID인 해시(Hash) 값이 변경됩니다. 따라서 이미 원격 저장소(GitHub, GitLab 등)에 푸시(Push)한 커밋에 대해서는 amend를 사용할 때 매우 신중해야 합니다. 동료가 이미 해당 커밋을 기반으로 작업을 하고 있다면 충돌이 발생할 수 있기 때문입니다.
누락된 파일을 포함하여 커밋 덮어쓰기
열심히 기능을 구현하고 커밋을 했는데, 새로 생성한 설정 파일이나 이미지 파일을 git add 하지 않은 채 커밋해버리는 경우도 빈번합니다. 보통은 '파일 추가'라는 이름으로 의미 없는 커밋을 하나 더 만들게 되는데, 이는 히스토리를 지저분하게 만드는 주범입니다. 이 기능은 논리적으로 하나의 작업 단위여야 하므로 하나의 커밋으로 합쳐져야 마땅합니다.
이럴 때도 amend가 빛을 발합니다. 먼저 누락된 파일을 git add 명령어로 스테이징 영역에 올립니다. 그 상태에서 바로 git commit --amend를 실행합니다. 그러면 깃은 스테이징 영역에 새로 올라온 파일과 직전 커밋의 내용을 합쳐서 새로운 커밋을 생성합니다. 결과적으로 파일이 누락되었던 실수는 역사 속에서 사라지고, 모든 파일이 완벽하게 포함된 하나의 깔끔한 커밋만 남게 됩니다. 별도의 메시지 수정이 필요 없다면 --no-edit 옵션을 붙여서 에디터가 열리는 과정을 생략할 수도 있어 생산성을 크게 높여줍니다.
과거의 실수를 바로잡는 타임머신: git rebase -i
amend는 바로 직전의 커밋만 수정할 수 있다는 한계가 있습니다. 그렇다면 이미 커밋을 3~4개 더 진행한 상태에서, 과거의 커밋에 오타가 있거나 파일을 빠뜨린 것을 발견했다면 어떻게 해야 할까요? 이때 reset을 사용하면 그 이후에 쌓아올린 모든 커밋을 다시 작업해야 하는 대참사가 벌어집니다. 이럴 때 사용하는 것이 바로 '대화형 리베이스(Interactive Rebase)'입니다.
리베이스의 -i 옵션(interactive)을 사용하면 특정 시점 이후의 커밋 목록을 에디터에 띄워놓고, 순서를 바꾸거나, 내용을 수정하거나, 여러 커밋을 하나로 합치는 등 마치 영상 편집을 하듯이 커밋 히스토리를 재구성할 수 있습니다. 이는 깃이 제공하는 가장 강력한 기능 중 하나이며, 중급 개발자로 넘어가기 위해 반드시 익혀야 할 기술입니다.
reword: 과거의 커밋 메시지만 수정하기
예를 들어, 현재 시점에서 3번째 전 커밋의 메시지를 수정하고 싶다고 가정해 봅시다. 터미널에 git rebase -i HEAD~3을 입력합니다. 그러면 에디터가 열리면서 최근 3개의 커밋 목록이 나타납니다. 각 커밋 앞에는 'pick'이라는 단어가 기본적으로 적혀 있습니다.
여기서 수정하고 싶은 커밋의 앞에 있는 'pick'을 지우고 'reword' (또는 약어인 r)로 변경합니다. 그리고 저장 후 에디터를 종료하면, 깃은 자동으로 리베이스 과정을 시작합니다. reword로 지정한 커밋 시점에 도달하면 잠시 멈추고 새 메시지를 입력할 수 있는 에디터 창을 띄워줍니다. 메시지를 수정하고 저장하면, 깃은 그 이후의 커밋들을 자동으로 다시 적용(Replay)하여 히스토리를 완성합니다. 이 모든 과정이 reset 없이 이루어지므로, 이후의 작업 내역은 안전하게 보존됩니다.
🔎 관련 상품 추천
아래 링크를 통해 구매 시 운영자에게 일정 수수료가 발생할 수 있습니다.
깃(Git) 커밋 메시지에 오타가 있거나 파일을 누락했을 때 reset 없이 amend와 rebase 명령어로 깔끔하게 이력을 수정하는 팁
'깃(Git) 커밋 메시지에 오타가 있거나 파일을 누락했을 때 reset 없이 amend와 rebase 명령어로 깔끔하게 이력을 수정하는 팁' 관련 상품을 쿠팡에서 확인해 보세요.
상품 보러가기 →
댓글
댓글 쓰기