잘못된 변경 되돌리기: revert와 reset 안전 가이드

언제 사용하나

방금 커밋/변경을 되돌려야 하는데 이력을 안전하게 다루고 싶을 때.

실행 전 확인

• 되돌릴 커밋이 이미 공유됐는지 확인한다(공유됐다면 revert 권장).

명령

# A) 이미 push된 커밋 되돌리기 → 되돌림 커밋 추가(이력 보존, 가장 안전)
git revert {{COMMIT}}

# B) 아직 push 안 한 마지막 커밋만 취소, 변경은 작업트리에 유지
git reset --soft HEAD~1     # 커밋만 취소, 스테이지 유지
git reset HEAD~1            # 커밋 취소, 변경은 남김(기본 mixed)

# C) 특정 파일을 마지막 커밋 상태로 되돌리기
git restore --source=HEAD --staged --worktree {{PATH}}

placeholder 설명

• {{COMMIT}} : 되돌릴 커밋 해시
• {{PATH}} : 파일 경로

입력 예시

공유된 실수 커밋: git revert a1b2c3d

기대 결과

변경이 안전하게 취소되고, 공유 이력은 보존된다.

검증 방법

git log와 git status로 의도한 상태인지 확인한다.

주의사항과 흔한 실수

• git reset --hard는 작업 내용을 삭제할 수 있어 기본 해법으로 쓰지 않는다. 꼭 필요하면 먼저 백업 브랜치를 만든다.
• 공유된 커밋에는 reset 대신 revert를 쓴다.

관련 문서

• git revert: https://git-scm.com/docs/git-revert