Git 커밋 수정하기 치트 시트
1. 마지막 커밋 수정하기
1.1 커밋 메시지만 수정하기
- 가장 최근 커밋의 메시지만 변경할 때 사용합니다.
git commit --amend -m "새로운 커밋 메시지"
- 에디터를 열어서 메시지를 수정하려면
-m옵션 없이 사용합니다.
git commit --amend
에디터 관련 팁
에디터가 vim으로 열린다면 i를 눌러 입력 모드로 전환하고, 수정 후 Esc를 누른 다음 :wq를 입력하여 저장하고 종료합니다.
1.2 파일 추가하면서 커밋 수정하기
- 빠뜨린 파일이나 추가 변경사항을 마지막 커밋에 포함시킬 때 사용합니다.
# 빠뜨린 파일 스테이징
git add forgotten-file.txt
# 마지막 커밋에 포함시키기 (메시지 수정)
git commit --amend
# 또는 메시지 변경 없이
git commit --amend --no-edit
주의사항
git commit --amend는 기존 커밋을 완전히 새로운 커밋으로 교체합니다. 이미 원격 저장소에 푸시된 커밋을 수정한 경우 강제 푸시(git push --force)가 필요할 수 있습니다.
2. 이전 커밋들 수정하기(rebase)
- 이전 커밋을 수정하려면
rebase -i명령어를 사용합니다.- 최신 커밋을 수정할 때는 git commit --amend를 사용할 수 있습니다.
- rebase를 사용하면 커밋 히스토리가 변경되므로, 이미 푸시된 커밋을 수정할 때는 팀원들과 협의가 필요합니다
2.1 백업 브랜치 생성
- 중요한 작업 전에는 항상 백업을 만들어두는 것이 좋습니다.
# 수정 전 백업
git branch backup-branch
# 수정 작업 수행
git rebase -i HEAD~3
# 문제 발생시 복구
git reset --hard backup-branch
2.2 최근 n개의 커밋 수정하기
- 여러 커밋을 한 번에 수정하거나 정리할 때 사용합니다.
# 최근 3개 커밋을 인터랙티브하게 수정
git rebase -i HEAD~3
# 이후 에디터가 열리면 수정할 커밋을 선택합니다.
pick 7ee1762 4
pick 9f1a8db 5
pick 464b89c 6
# Rebase f9f3985..464b89c onto f9f3985 (3 commands)
#
# Commands:
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# e, edit <commit> = use commit, but stop for amending
# s, squash <commit> = use commit, but meld into previous commit
# f, fixup <commit> = like "squash", but discard this commit's log message
# x, exec <command> = run command (the rest of the line) using shell
# b, break = stop here (continue rebase later with 'git rebase --continue')
# d, drop <commit> = remove commit
# l, label <label> = label current HEAD with a name
# t, reset <label> = reset HEAD to a label
# m, merge [-C <commit> | -c <commit>] <label> [# <oneline>]
# . create a merge commit using the original merge commit's
# . message (or the oneline, if no original merge commit was
# . specified). Use -c <commit> to reword the commit message.
#
# These lines can be re-ordered; they are executed from top to bottom.
- 위 명령어를 실행하면 에디터가 열리고, 최근 3개의 커밋 목록이 표시됩니다.
- 각 커밋 앞에 있는 명령어를 변경하여 원하는 작업을 수행할 수 있습니다.
# 이후 에디터가 열리면 수정할 커밋을 선택합니다.
pick 7ee1762 4
pick 9f1a8db 5
r 464b89c 6
# Rebase f9f3985..464b89c onto f9f3985 (3 commands)
#
# Commands:
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# e, edit <commit> = use commit, but stop for amending
# s, squash <commit> = use commit, but meld into previous commit
# f, fixup <commit> = like "squash", but discard this commit's log message
# x, exec <command> = run command (the rest of the line) using shell
# b, break = stop here (continue rebase later with 'git rebase --continue')
# d, drop <commit> = remove commit
# l, label <label> = label current HEAD with a name
# t, reset <label> = reset HEAD to a label
# m, merge [-C <commit> | -c <commit>] <label> [# <oneline>]
# . create a merge commit using the original merge commit's
# . message (or the oneline, if no original merge commit was
# . specified). Use -c <commit> to reword the commit message.
#
# These lines can be re-ordered; they are executed from top to bottom.
- 464b89c 커밋의 메시지를 수정하려면
reword명령어를 사용합니다. 줄여서r로 표시할 수 있습니다. - 에디터를 저장하고 종료하면, Git이 해당 커밋을 수정하기 위해 멈춥니다.
666
# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
#
# Date: Fri Jun 13 00:00:31 2025 +0900
#
# interactive rebase in progress; onto f9f3985
# Last commands done (3 commands done):
# pick 9f1a8db 5
# reword 464b89c 6
# No commands remaining.
# You are currently editing a commit while rebasing branch 'master' on 'f9f3985'.
#
# Changes to be committed:
# modified: REAM.md
#
# Untracked files:
# asdfsadf
#
"~/Desktop/project/study/git-demo/.git/COMMIT_EDITMSG" 20L, 603B
- 이제 에디터가 열리면 커밋 메시지를 수정할 수 있습니다.
2.2.1 에디터에서 나타나는 옵션들
에디터에서 각 커밋 앞의 명령어를 변경하여 다양한 작업을 수행할 수 있습니다.
# 예시 화면:
# pick a1b2c3d 첫 번째 커밋
# pick e4f5g6h 두 번째 커밋
# pick i7j8k9l 세 번째 커밋
사용 가능한 명령어:
pick (p): 커밋을 그대로 유지reword (r): 커밋 메시지만 변경edit (e): 커밋을 수정하기 위해 멈춤squash (s): 이전 커밋과 합치기 (메시지 결합)fixup (f): 이전 커밋과 합치되 메시지는 버리기drop (d): 커밋 삭제
3. reset 명령어 사용하기
3.1 reset 옵션별 차이점
- Git reset은 세 가지 주요 옵션이 있으며, 각각 다른 영역에 영향을 미칩니다.
- reset 명령으로 삭제된 커밋을 복구하고 싶다면
git reflog를 사용해야 합니다.
3.1.1 git reset --soft
- HEAD만 이동시키고 스테이징 영역과 작업 디렉토리는 그대로 유지합니다.
- 커밋만 취소하고 변경사항은 스테이징된 상태로 보존됩니다.
git reset --soft HEAD~1
3.1.2 git reset --mixed (기본값)
- HEAD와 스테이징 영역을 초기화하지만 작업 디렉토리는 유지합니다.
- 커밋과 스테이징을 취소하지만 파일 변경사항은 보존됩니다.
git reset HEAD~1
# 또는
git reset --mixed HEAD~1
3.1.3 git reset --hard
- HEAD, 스테이징 영역, 작업 디렉토리를 모두 초기화합니다.
- 모든 변경사항이 완전히 삭제됩니다.
git reset --hard HEAD~1
위험!
git reset --hard는 작업 디렉토리의 모든 변경사항을 삭제합니다. 사용하기 전에 중요한 변경사항이 없는지 반드시 확인하세요.
3.2 여러 커밋 삭제하기
3.2.1 최근 n개의 커밋 완전 삭제
# 최근 3개 커밋을 완전히 삭제
git reset --hard HEAD~3
3.2.2 커밋은 삭제하되 변경사항은 스테이징 영역에 보존
# 최근 3개 커밋을 삭제하지만 변경사항은 스테이징된 상태로 유지
git reset --soft HEAD~3
3.2.3 커밋과 스테이징은 삭제하되 파일 변경사항은 보존
# 최근 3개 커밋을 삭제하고 변경사항은 작업 디렉토리에 언스테이징된 상태로 유지
git reset HEAD~3
4. 삭제된 커밋 복구하기
4.1 git reflog 사용하기
- Git reflog는 HEAD의 변경 이력을 보여주어 삭제된 커밋을 복구할 수 있게 해줍니다.
# reflog 확인
git reflog
4.1.1 reflog 출력 예시
a1b2c3d HEAD@{0}: reset: moving to HEAD~1
e4f5g6h HEAD@{1}: commit: 삭제된 커밋
i7j8k9l HEAD@{2}: commit: 이전 커밋
4.2 커밋 복구 방법
4.2.1 특정 커밋으로 되돌리기
# 특정 커밋 해시로 되돌리기
git reset --hard e4f5g6h
# 또는 reflog 참조 사용
git reset --hard HEAD@{1}
reflog 보존 기간
Git reflog는 기본적으로 90일 동안 유지됩니다. 시간이 너무 오래 지나면 복구가 불가능할 수 있으므로 가능한 빨리 복구 작업을 수행하세요.
5. untracked 파일 처리하기
5.1 untracked 제거하기
- Git에서 추적되지 않는(untracked) 파일을 제거하려면
git clean명령어를 사용합니다. - git clean으로 삭제된 파일은 Git 히스토리에 없으므로 복구 불가합니다.
- 반드시 -n 옵션으로 먼저 확인해야 합니다.
# 지워질 파일들 미리 확인 (실제로 지우지 않음)
git clean -n
# 또는
git clean --dry-run
# untracked 파일들 삭제
git clean -f
# untracked 디렉토리까지 삭제
git clean -fd
6. 작업 내용 임시 저장하기
- 작업 중인 내용을 임시로 저장하고 나중에 복구할 때는
git stash명령어를 사용합니다. - 작업 도중 브랜치를 변경할 때 유용합니다.
- working directory와 staging area의 변경사항을 임시로 저장하고 깨끗한 상태로 되돌립니다.
- 이후 브랜치를 변경한 후 작업을 완료합니다.
- 다시 원래 브랜치로 돌아와서
git stash pop명령어로 임시 저장된 작업 내용을 복구합니다.
6.1 stash 사용하기
# 현재 working directory와 staging area의 변경사항이 있는 상태
git status
On branch test
Changes to be committed:
(use "git restore --staged <file>..." to unstage)
modified: asdfsadf
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: asdfsadf
# 다른 브랜치로 이동이 불가능함
git switch master
error: Your local changes to the following files would be overwritten by checkout:
asdfsadf
Please commit your changes or stash them before you switch branches.
Aborting
# 임시로 작업 내용을 저장
git stash push -m "try1"
Saved working directory and index state On test: try1
# working directory와 staging area가 깨끗한 상태로 되돌아감
git status
On branch test
nothing to commit, working tree clean
# 다른 브랜치로 이동 가능
git switch master
# 작업 완료 후 원래 브랜치로 돌아옴
git switch test
# 임시 저장된 작업 내용 복구
git stash pop
On branch test
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: asdfsadf
no changes added to commit (use "git add" and/or "git commit -a")
Dropped refs/stash@{0} (15c43149b43c0221d739a030505e09d3190aa843)
# 작업 내용이 working directory에 복구 됨
git status
On branch test
Changes not staged for commit:
(use "git add <file>..." to update what will be committed)
(use "git restore <file>..." to discard changes in working directory)
modified: asdfsadf
no changes added to commit (use "git add" and/or "git commit -a")
7. 실전 팁과 주의사항
7.1 안전한 Git 사용을 위한 팁
- 백업 습관: 중요한 작업 전에는 항상 백업 브랜치를 생성하세요.
- 자주 커밋: 작은 단위로 자주 커밋하여 손실 위험을 줄이세요.
- 원격 저장소 활용: 정기적으로 원격 저장소에 푸시하여 백업을 유지하세요.
7.2 공유된 브랜치에서 주의사항
- 다른 팀원과 공유하는 브랜치에서는
git reset --hard나git commit --amend사용을 피하세요. - 이미 푸시된 커밋을 수정할 때는 팀원과 사전 협의가 필요합니다.
- 강제 푸시(
git push --force) 대신git push --force-with-lease를 사용하는 것이 더 안전합니다.
7.3 복구 불가능한 상황
- 커밋되지 않은 변경사항은
git reset --hard후 복구가 불가능합니다. git stash를 활용하여 임시 변경사항을 보관하는 습관을 기르세요.
# 임시 변경사항 보관
git stash
# 위험한 작업 수행
git reset --hard HEAD~3
# 필요시 변경사항 복구
git stash pop