git commit 커밋 수정 실무: --amend와 --fixup으로 메시지·이력 정리하기

git commit 커밋 수정 실무: --amend와 --fixup으로 메시지·이력 정리하기

git commit은 변경 이력을 팀 지식으로 남기는 단계다. --amend와 --fixup을 알면 리뷰 대응 속도와 히스토리 가독성이 크게 좋아진다.

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

기본 사용법

git commit -m 'feat(api): add order cancel endpoint'
git commit --amend --no-edit

자주 쓰는 옵션 5가지

항목	의미	언제 쓰는지(실무 상황)
-m	커밋 메시지 직접 지정	빠른 단일 커밋 작성 시
--amend	직전 커밋 수정	메시지 오타, 파일 누락을 바로 고칠 때
--no-edit	기존 메시지 유지	내용만 추가하고 메시지는 유지할 때
--fixup	특정 커밋 보정용 커밋 생성	리뷰 반영 후 autosquash를 준비할 때
--no-verify	훅 검사 생략	긴급 복구 시 임시 우회가 필요할 때

문제 상황

상황: 커밋 메시지가 모호해 장애 원인 추적이 늦어진다.
원인: 메시지 규칙 없이 급하게 커밋했다.
해결: 직전 커밋은 --amend로 즉시 수정하고, 이미 공유된 커밋은 후속 커밋으로 맥락을 보완한다.
예방 팁: 팀 공통 커밋 템플릿과 commitlint를 적용한다.

참고/출처

공식 문서: git-commit manual
공식 문서: Pro Git - Recording Changes
신뢰 자료: GitHub Docs - commit and push