git fixup

• git fixup은 이전 커밋의 내용을 수정하기 위한 특수 커밋 생성 옵션
• git rebase --autosquash와 함께 사용하여 커밋 히스토리를 깔끔하게 정리하는 워크플로우
• fixup!, amend! 접두사로 대상 커밋을 자동 식별하는 메커니즘

해당 개념이 필요한 이유

• 코드 리뷰 후 수정사항을 기존 커밋에 깔끔하게 병합하고 싶을 때
• 커밋 히스토리를 논리적 단위로 유지하면서 점진적으로 수정할 때
• 수동으로 interactive rebase에서 pick → fixup 변경하는 번거로움을 없애기 위해

AS-IS

sequenceDiagram
    autonumber
    participant Dev as Developer
    participant Git as Git

    Dev->>Git: git commit -m "Add login feature"
    Dev->>Git: git commit -m "Fix typo in login"
    Dev->>Git: git commit -m "Add logout feature"
    Dev->>Git: git commit -m "Fix login validation"
    Note over Git: 히스토리가 산발적 ❌<br/>login 관련 수정이 흩어져 있음

TO-BE

sequenceDiagram
    autonumber
    participant Dev as Developer
    participant Git as Git

    Dev->>Git: git commit -m "Add login feature"
    Dev->>Git: git commit --fixup HEAD~2 (typo 수정)
    Dev->>Git: git commit -m "Add logout feature"
    Dev->>Git: git commit --fixup HEAD~3 (validation 수정)
    Dev->>Git: git rebase -i --autosquash main
    Note over Git: 히스토리가 깔끔 ✅<br/>"Add login feature" (수정 포함)<br/>"Add logout feature"

선행 개념: Interactive Rebase

interactive rebase (git rebase -i)는 커밋 히스토리를 대화형으로 편집하는 기능.

git rebase -i HEAD~5   # 최근 5개 커밋을 편집 대상으로 열기

실행하면 에디터에 todo 리스트가 열림:

pick abc1234 feat: Add login
pick def5678 fix: typo
pick ghi9012 feat: Add logout
pick jkl3456 fix: login validation

각 줄의 pick을 다른 명령으로 바꿀 수 있음:

명령	설명
pick (p)	커밋 그대로 사용
reword (r)	커밋 메시지만 변경
edit (e)	커밋에서 멈춰서 수정 가능
squash (s)	이전 커밋에 합치기 (메시지 합침)
fixup (f)	이전 커밋에 합치기 (메시지 버림)
drop (d)	커밋 삭제

줄의 순서를 바꾸면 커밋 순서도 변경됨.

선행 개념: Squash vs Fixup

둘 다 커밋을 이전 커밋에 합치는 동작이지만 커밋 메시지 처리가 다름:

pick abc1234 feat: Add login feature
squash def5678 fix: typo in login

→ 에디터가 열리며 두 메시지를 합쳐서 편집 가능

pick abc1234 feat: Add login feature
fixup def5678 fix: typo in login

→ fixup 커밋의 메시지는 자동으로 버림, 원본 메시지만 유지

	squash	fixup
코드 변경	합침	합침
커밋 메시지	두 메시지 합쳐서 편집	원본 메시지만 유지
에디터	열림	열리지 않음
용도	메시지도 보존하고 싶을 때	조용히 수정만 반영할 때

선행 개념: Autosquash

--autosquash는 fixup!, squash!, amend! 접두사가 붙은 커밋을 자동으로 정렬하고 명령을 변경해주는 옵션.

수동 interactive rebase에서는:

1. 에디터 열림
2. fixup 커밋을 직접 대상 커밋 아래로 이동
3. pick → fixup으로 직접 변경

autosquash를 쓰면 이 과정이 전부 자동화:

git rebase -i --autosquash main

# 자동으로 이렇게 정리됨:
pick abc1234 feat: Add login feature
fixup def5678 fixup! feat: Add login feature   ← 자동 배치 + 자동 fixup
pick ghi9012 feat: Add logout feature

기본값으로 설정:

git config --global rebase.autoSquash true

이후 git rebase -i만 해도 autosquash 동작.

fixup의 3가지 모드

1. 기본 fixup — 내용만 수정

git commit --fixup=<commit>

• 대상 커밋의 **내용(코드)**만 변경
• 커밋 메시지는 원본 그대로 유지
• "fixup! <원본 커밋 메시지>" 형식의 커밋 생성

# 예시: 3개 전 커밋의 버그를 수정
git add fixed_file.py
git commit --fixup=HEAD~2
# → "fixup! Add login feature" 커밋 생성

2. amend 모드 — 내용 + 메시지 수정

git commit --fixup=amend:<commit>

• 대상 커밋의 내용과 커밋 메시지 모두 변경
• "amend! <원본 커밋 메시지>" 형식의 커밋 생성
• 에디터가 열려 메시지를 수정할 수 있음

3. reword 모드 — 메시지만 수정

git commit --fixup=reword:<commit>

• --fixup=amend:<commit> --only의 축약형
• 대상 커밋의 메시지만 변경 (staging된 코드 변경 무시)
• 코드 변경 없이 커밋 메시지만 고치고 싶을 때 사용

전체 워크플로우

# 1. 일반 커밋들 작성
git commit -m "feat: Add user authentication"
git commit -m "feat: Add dashboard page"
git commit -m "feat: Add profile settings"
 
# 2. authentication 커밋에 수정이 필요하다면
git add auth_fix.py
git commit --fixup=HEAD~2
 
# 3. autosquash로 rebase
git rebase -i --autosquash main

rebase todo 리스트가 자동으로 아래처럼 정리됨:

pick abc1234 feat: Add user authentication
fixup def5678 fixup! feat: Add user authentication   ← 자동 배치
pick ghi9012 feat: Add dashboard page
pick jkl3456 feat: Add profile settings

대상 커밋 지정 방법

git commit --fixup=HEAD~3        # 3개 전 커밋
git commit --fixup=abc1234       # 커밋 해시로 지정
git commit --fixup=:/login       # "login"이 포함된 가장 최근 커밋

참고 문서

• git-commit 공식 문서
• git-rebase 공식 문서