🐙 Git으로 특정 파일을 과거 커밋 버전으로 되돌리는 방법

프로젝트 전체를 되돌리지 않고, 특정 파일만 과거 버전으로 복원하는 방법을 알아봅니다.
✅ 안전하고 ✅ 선택적으로 되돌릴 수 있어 실무에서도 자주 사용됩니다.

---

✅ 1. 커밋 ID 확인하기

특정 파일을 되돌리려면 커밋 ID가 필요합니다.

🔹 VS Code에서

1. Timeline 뷰(파일 우측 사이드바) 열기
2. 되돌리고 싶은 커밋에서 우클릭 → Copy Commit ID
3. 복사한 해시 사용 (예: 2c8e198)

🔹 Git 터미널에서

git log --oneline

예시 출력:

2c8e198 feat: 이슈 카테고리 수정
f8ef6d6 fix: 버그 수정
...

→ 2c8e198가 커밋 ID.

---

✅ 2. 특정 파일만 과거 버전으로 복원하기

커밋 ID를 알았다면 다음 명령어를 실행하세요.

git checkout <commit_hash> -- <파일경로>

예:

git checkout 2c8e198 -- utils.py

📌 이 명령어의 특징

• 브랜치 전체는 그대로 유지
• 지정한 파일만 과거 버전으로 덮어쓰기
• 아직 커밋하지 않았으므로 필요 시 다시 수정 가능

---

✅ 3. 복원 후 커밋하기 (선택)

파일을 복구한 후 그대로 유지하고 싶다면 커밋합니다.

git add utils.py
git commit -m "Revert utils.py to commit 2c8e198"

---

✅ 4. GUI로도 가능할까?

VS Code의 Timeline은 커밋 버전 미리보기 및 복사까지만 지원합니다.
GitLens 확장을 사용하면 GUI에서도 Checkout/Restore 기능을 제공하여 명령어 없이도 되돌릴 수 있습니다.

---

🟢 마무리

✔️ 커밋 ID만 알면 전체 프로젝트가 아닌 특정 파일만 안전하게 되돌릴 수 있음
✔️ 되돌린 후 필요 시 새로운 커밋으로 반영
✔️ VS Code + GitLens 조합이면 GUI에서도 쉽게 가능