[Git] 이미 Git에 올라간 파일 .gitignore 추가하기

 

GitHub에 올리고 싶지 않은 폴더가 이미 커밋되어 올라갔다면 .gitignore만 추가해선 해결되지 않는다.
Git이 이미 “추적 중”인 파일을 직접 제거해줘야 한다.

 

방법은

1. .gitignore 수정
2. Git 캐시에서 제거 (git rm -r --cached)
3. 실수했을 때는 git restore --staged .로 복구 가능)
4. 최종 커밋

 

아래는 각 과정 명령어를 자세히 정리해보았다.

---

 

1. 제외할 파일 .gitignore 에 추가하기

Git에게 어떤 폴더를 앞으로 무시할지 미리 알려준다. 이미 기존에 있는  .gitignore 파일에 추가하고 싶은 내용을 작성한다.

# 기존
__pycache__/
*.pyc
*.log
.env

# 새로 추가한 부분
workspace/
multi_agent/data/
multi_agent/logs/

이 단계는 앞으로 생성되는 파일부터 적용되고, 하지만 이미 올라간 파일에는 영향이 없다. 

그래서 이미 올라간 파일에는 기존에 올라가있는 캐시! 를 삭제해주어야한다.

 

---

2. 기존에 올라간 폴더 캐시 제거

이 부분이 핵심이다. .gitignore는 “앞으로 무시할 파일”만 관리한다.
그래서 이미 Git이 추적 중인 폴더를 무시하려면 Git 캐시에서 제거하는 작업을 따로 해야 한다.

 

git rm -r --cached workspace
git rm -r --cached multi_agent/data
git rm -r --cached multi_agent/logs

이 명령을 실행하면:

• 실제 폴더는 그대로 남아있고
• Git에서만 추적이 중단된다

이 명령은 전체 프로젝트 파일을 캐시에서 제거하는 명령어이다.

git rm -r --cached .

 

---

3. 실수로 전체 캐시를 제거했을 때 복구하는 방법

일부 캐시만 지웠어야했는데 실수로 전체 캐시를 지웠을 경우 ,아직 커밋하지 않았다면 아래 명령으로 즉시 복구할 수 있다.

git restore --staged .

이걸 실행하면 “전체 제거되기 전의 상태”로 되돌아온다.

복구 후에는 2번 명령어 처럼 다시 정확히 제외할 폴더만 선택하여 Git 추적을 끊어준다.

 

 

이렇게 하면 이미 올라가 있던 불필요한 폴더들도 깔끔하게 정리되고,
앞으로는 자동으로 무시되기 때문에 Git 관리가 훨씬 편해진다.

---

4. 최종 커밋으로 정리 완료

캐시 제거 후 변경사항을 commit 하면 정리가 끝난다.

git add .
git commit -m "chore: remove tracked workspace/data/logs and apply .gitignore"