15강. 작업 취소: restore, revert, reset의 차이

?1. 이번 강의에서 해결할 문제

“되돌리기”라는 목적만 보고 reset --hard를 복사하면 커밋되지 않은 작업을 복구하기 어렵게 잃을 수 있습니다. 작업 폴더, stage, 공유 이력 중 무엇을 바꿀지 먼저 구분합니다.

✓2. 학습 목표

✓이 강의를 마치면

• restore, revert, reset의 대상과 이력 영향을 구분합니다.
• 공개된 잘못된 커밋을 새 커밋으로 취소합니다.
• 파괴적 명령 전에 복구 지점을 만듭니다.

◇3. 핵심 개념

restore는 파일 내용을 복원하거나 stage에서 내립니다. revert는 과거 커밋을 상쇄하는 새 커밋을 만들어 공유 이력에 안전합니다. reset은 현재 브랜치가 가리키는 커밋을 옮기며 옵션에 따라 stage와 작업 파일도 바꿉니다.

§4. 단계별 명령어와 예시

실습 경로: C:\dev\git-learning-site

PowerShell · 커밋 전

git status
git diff -- README.md
git restore -- README.md
git restore --staged profile.md

공유된 커밋 취소: 먼저 대상 내용을 확인합니다.

PowerShell · 공유 이력

git show --stat <commit-id>
git revert <commit-id>
git push

git reset --hard <commit>은 작업 폴더와 stage를 대상 커밋으로 강제 맞춰 커밋하지 않은 변경을 삭제합니다. 일반 학습 흐름에서는 사용하지 않습니다. 꼭 필요한 개인 브랜치에서도 먼저 아래처럼 복구 브랜치를 만들고 status를 확인합니다.

PowerShell · 안전장치

git status
git branch backup/before-reset
git log --oneline -n 5

→5. 명령어가 동작하는 이유

restore는 브랜치 포인터를 움직이지 않습니다. revert는 반대 patch를 새 커밋으로 적용해 과거 커밋과 취소 사실을 모두 남깁니다. reset은 브랜치 참조 자체를 옮기므로 공유된 이력에 쓰면 다른 복제본과 충돌합니다.

!6. 자주 하는 실수와 안전한 해결법

!자주 하는 실수

• 작업 파일을 확인하지 않고 restore: 실행 전 git diff -- <경로>를 읽습니다.
• main의 공개 커밋을 reset 후 force push: 협업 이력을 바꿉니다. git revert를 사용합니다.
• 복구 지점 없이 hard reset: 먼저 백업 브랜치나 stash를 만들고, 가능하면 soft/mixed reset 또는 restore 대안을 선택합니다.

✎7. 직접 실습

✎직접 실습

1. 커밋하지 않은 테스트 문장을 restore로 취소합니다.
2. 파일 하나를 add한 뒤 restore --staged로 내립니다.
3. 연습 브랜치에서 작은 커밋을 만들고 revert해 두 커밋이 모두 log에 남는지 확인합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. 이미 공유된 잘못된 커밋을 취소할 때 우선할 명령은 무엇인가요?
2. reset --hard가 바꾸는 세 영역은 무엇인가요?
3. stage에서만 파일을 내리고 작업 내용은 유지하는 명령은 무엇인가요?

■9. 핵심 요약

■핵심 요약

취소하려는 대상과 공유 여부를 먼저 확인합니다. 파일은 restore, 공개 이력은 revert를 우선하며, reset 특히 --hard는 복구 지점과 정확한 이유가 있을 때만 사용합니다.