git checkout 되돌리기와 브랜치 이동: 파일 복구까지 안전하게 쓰는 법

git checkout 되돌리기와 브랜치 이동: 파일 복구까지 안전하게 쓰는 법

git checkout은 여전히 많은 레거시 프로젝트에서 사용된다. 브랜치 전환과 파일 복구 기능이 함께 있어 강력하지만 오용하면 데이터 손실 위험이 있다.

checkout으로 브랜치 이동하는 예시 (출처: Pro Git, git-scm.com)

기본 사용법

git checkout develop
git checkout -b feature/cache-key
git checkout -- src/config/app.yml

자주 쓰는 옵션 4가지

항목	의미	언제 쓰는지(실무 상황)
-b	브랜치 생성 후 이동	기능 개발 브랜치를 빠르게 만들 때
-B	브랜치 강제 리셋 후 이동	실험 브랜치 재사용 시
--	경로 구분자로 파일 복구	특정 파일 변경만 취소하고 싶을 때
--detach	특정 커밋으로 분리 이동	과거 릴리스 버전 재현 테스트 시

문제 상황

상황: checkout으로 파일을 되돌린 뒤 수정본을 잃어버렸다.
원인: stash나 임시 커밋 없이 작업 파일을 덮어썼다.
해결: reflog에서 커밋/HEAD 이동 이력을 찾아 복구하고, 잦은 실험은 별도 브랜치에서 수행한다.
예방 팁: 파일 복구 전 반드시 diff 백업을 남기거나 stash를 사용한다.

참고/출처

공식 문서: git-checkout manual
공식 문서: Pro Git - Basic Branching
신뢰 자료: Atlassian - git checkout