git rm 실무 정리: 추적 파일 삭제와 캐시 제외 처리, 복구까지 한 번에

git rm 실무 정리: 추적 파일 삭제와 캐시 제외 처리, 복구까지 한 번에

git rm은 파일 시스템 삭제와 Git 추적 제거를 동시에 처리한다. 단순 rm과 달리 이력 반영까지 포함되므로 옵션 이해가 중요하다. 초보~중급 개발자가 바로 적용할 수 있도록 명령어 흐름, 옵션 선택 기준, 복구 절차를 실무 중심으로 설명한다.

공식 Git 로고 (출처: git-scm.com)

git rm 기본 사용 패턴

git rm --cached .env
echo .env >> .gitignore
git commit -m "chore: stop tracking local env file"

자주 쓰는 옵션 3~6개

항목	의미	언제 쓰는지(실무 상황)
--cached	작업 파일은 유지하고 추적만 제거	이미 커밋된 민감 파일을 추적에서 빼고 싶을 때
-r	디렉터리 재귀 삭제	폴더 단위 정리가 필요할 때
-f	강제 삭제	수정된 파일 삭제를 강행할 때
--ignore-unmatch	대상 없을 때도 오류 없이 종료	스크립트 자동화에서 안정 처리할 때

실무 적용 순서

1) 실행 전 상태 확인

git status와 git log로 현재 위치를 확인한다. 특히 원격 공유 브랜치인지, 로컬 전용 브랜치인지 먼저 판단해야 안전하다.

2) 목적에 맞는 옵션 선택

동일 명령어라도 옵션에 따라 이력 보존, 충돌 위험, 협업 영향이 달라진다. 팀 정책과 배포 단계에 맞춰 옵션을 고른다.

3) 실행 후 검증

명령 실행 뒤에는 status, diff, 테스트를 통해 결과를 검증한다. 필요하면 즉시 복구 명령(reflog, revert, stash)을 연계한다.

문제 상황 1개

상황: 실수로 민감 설정 파일이 저장소에 포함됐다.
원인: ignore 규칙 없이 파일을 add해 추적이 시작됐다.
해결: rm --cached로 추적을 해제하고 ignore를 추가한 뒤 보안 키를 즉시 교체한다.
예방 팁: 프로젝트 시작 시 공통 ignore 템플릿과 비밀 스캔을 설정한다.

참고/출처

공식 문서: git-rm manual
공식 문서: Pro Git - Recording Changes
신뢰 자료: Atlassian - git rm