Git 관리에 유용한 명령어: git clean -fd

Git 관리에 유용한 명령어: git clean -fd

개발을 하다 보면 프로젝트 폴더 안에 점점 많은 파일들이 쌓이게 됩니다.

특히 Git으로 관리하지 않는 임시 파일, 빌드 결과물, 로그 파일 등은 매번 정리하기 번거롭죠.

이럴 때 git clean 명령어를 사용하면 한 번에 깔끔하게 정리할 수 있습니다.

이번 글에서는 그 중 git clean -fd 명령어를 간단하게 살펴보겠습니다.

---

git clean이란?

git clean은 Git에서 추적하지 않는 파일들을 제거해주는 명령어입니다.

예를 들어 빌드 과정에서 자동으로 생성되는 파일이나 .gitignore에 포함시키지 않은 임시 파일 등이 여기에 해당합니다.

이런 파일들은 버전 관리 대상이 아니므로 필요할 때마다 다시 만들면 됩니다.

그래서 이 파일들을 간편하게 삭제하기 위해 git clean을 사용합니다.

---

git clean -fd 옵션 살펴보기

• -f (--force): 실제로 파일을 강제로 지웁니다. 안전장치 없이 바로 삭제하므로 주의가 필요합니다.
• -d: 추적되지 않는 디렉토리도 함께 삭제합니다.

즉, git clean -fd를 실행하면 Git이 추적하지 않는 파일과 디렉토리를 모두 한 번에 싹 정리할 수 있습니다.

---

사용 예시

아래와 같이 git status에서 추적되지 않는 파일이 보인다고 가정해봅시다.

Untracked files:
  build/
  temp.log
  node_modules/

이때 다음 명령어를 실행하면:

git clean -fd

build/, temp.log, node_modules/ 모두 사라집니다.

다시 git status를 보면 "working tree clean" 메시지를 확인할 수 있죠.

---

주의사항 및 팁

- 드라이런(Dry-run) 사용: 바로 지우기 전에 어떤 파일이 삭제될지 확인하고 싶다면 -n 옵션을 사용하세요.이렇게 하면 삭제될 항목만 보여주고 실제로는 삭제하지 않습니다.

git clean -fdn

 

- .gitignore 관리: 자주 생성되는 임시 파일들은 .gitignore에 추가해두면 매번 정리할 필요 없이 깔끔한 환경을 유지할 수 있습니다.

 

- 중요한 파일 백업: 삭제 이후 복구하기 어렵습니다. 혹시라도 중요한 파일이 있다면 백업해두세요.

---

마무리

git clean -fd는 프로젝트를 정리하고 관리하는 데 매우 유용한 명령어입니다. 자주 쓰기 전에는 -n 옵션을 통해 미리 확인하는 습관을 들이고, .gitignore를 잘 관리해 불필요한 파일이 자주 등장하는 것을 막는다면 더욱 효율적으로 사용할 수 있습니다.