[Git] 아차! 실수했다... 커밋 메시지 수정하는 법

열심히 커밋을 남겼는데 오타를 발견했거나, 규칙을 깜빡하고 '수정'이라고만 적어버린 적 있으시죠? 당황하지 마세요. Git에는 과거를 되돌릴 수 있는 강력한 타임머신 기능이 있습니다.

상황별로 가장 자주 쓰이는 세 가지 해결책을 깔끔하게 정리해 드립니다.

 

1. 방금 만든 커밋 메시지 수정하기 (--amend)

가장 많이 발생하는 상황입니다. 방금 'commit' 버튼을 눌렀는데 바로 오타를 발견했을 때 사용합니다.

• 명령어: git commit --amend -m "새로운 메시지"
• 설명: 이 명령어를 치면 방금 올린 커밋이 사라지고, 새로운 메시지가 담긴 커밋으로 덮어쓰기 됩니다. 코드 변경 없이 메시지만 바꾸고 싶을 때 아주 유용합니다.

 

2. 조금 지난 과거의 메시지 수정하기 (rebase -i)

방금 전이 아니라 2~3개 전, 혹은 더 오래된 커밋 메시지를 고치고 싶을 때 사용하는 고수들의 기술입니다.

수정 단계:

1. 지점 찾기: 터미널에 git rebase -i HEAD~3을 입력합니다. (최근 3개 커밋을 보겠다는 뜻입니다.)
2. 명령 변경: 편집기가 열리면 수정하고 싶은 커밋 옆의 pick이라는 글자를 reword(또는 r)로 바꾸고 저장합니다.
3. 메시지 고치기: 다시 열리는 편집기 창에서 진짜 원하는 메시지로 수정한 후 저장하면 끝!

 

3. 이미 푸시(Push)한 메시지 수정하기

이미 팀원들이 사용하는 원격 저장소(GitHub 등)에 코드를 올려버렸다면 조금 더 주의가 필요합니다.

1. 위에서 배운 방법(--amend나 rebase)으로 내 컴퓨터의 메시지를 먼저 수정합니다.
2. 수정된 내용을 강제로 반영합니다: git push origin 브랜치명 --force

⚠️ 주의사항: --force는 저장소의 역사를 강제로 바꾸는 기능입니다. 다른 팀원과 함께 작업 중인 브랜치라면 기록이 꼬일 수 있으니, 혼자 작업하는 브랜치에서만 사용하는 것을 권장합니다.

 

💡 한눈에 보는 상황별 해결법

상황	사용해야 할 명령어	특징
직전 커밋 수정	Git commit --amend	가장 쉽고 안전함
과거 커밋 수정	git rebase -i HEAD~n	여러 개를 한꺼번에 고칠 때 유용
이미 원격에 올림	수정 후 push --force	팀원과 상의 후 사용 권장

 

마치며

rebase는 단순히 글자만 바꾸는 게 아니라 커밋의 고유 ID를 새로 생성하는 작업입니다. 따라서 협업 중에는 늘 신중해야 하죠. 가장 좋은 방법은 커밋하기 전, 'commit' 규칙에 맞게 썼는지 한 번 더 확인하는 습관을 들이는 것입니다!