GitHub 업로드 전, 커밋에서 특정 파일 빼는 법

⚠️ 문제상황

팀플 진행 중 GitHub에 업로드하는 과정에서 의도치 않게 불필요한 파일까지 함께 추가되는 일이 발생했다. 그래서 이번에는 커밋/푸시 전에 특정 파일을 선택적으로 제외하는 방법을 적용해보려 한다.

git status로 확인한 뒤 git add .를 실행했더니, 압축파일까지 함께 커밋 대상이된 것을 확인할 수 있었다. 이 압축파일은 GitHub에 올릴 필요가 없으므로, 커밋 대상에서 제외(제거)해보도록 하겠다.

✅ 커밋 대상에서 특정 파일 제외하기

git restore --staged는 커밋 대상(커밋 준비 목록) 에 올라간 파일을 다시 내려주는 명령어다.
즉, 파일은 그대로 두고 커밋에 포함하지 않도록 만들 수 있다.

실행후 git status로 상태를 확인해보면 제거할 파일이 추가한 목록에서 빠져있는것을 볼수 있다 

🚀 commit과 push 실행

파일이 빠진것을 확인했다면 바로 git commit을 진행 시켜 메세지를 작성한다

git push 실행

🗑️ 불필요한 파일 제거하기 

파일제거가 필수적으로 필요한것은 아니고 현재 사용하지 않을 파일이라서 제거해주었다

🛡️ gitignore 설정해서 특정파일만 무시하기

gitignore는 “Git이 추적(관리)하지 말아야 할 파일/폴더 목록”을 적어두는 파일이다

gitignore가 있는지 먼저 확인후 없다면 만들어야한다

cd D:\gitflow\ornably
dir

윈도우 메모장을 사용하여 gitignore 파일을 생성한다

notepad .gitignore

생성한 gitignore 파일에 git에서 무시할 파일 경로를 적어준다

ornably/src/main/java/bugsandwich/ornably/security.zip

저장후 git stutas로 상태확인을 하고 커밋후 팀원에게 공유한다

git add .gitignore
git commit -m "chore: add gitignore"

🚨 주의

이미 깃이 추척시작한 파일은 gitignore설정만으로 사라지지 않는다

• Untracked(빨간색으로 뜨는 파일) → .gitignore로 바로 숨길 수 있음 ✅
• Tracked(이미 add/commit 된 파일) → .gitignore에 넣어도 계속 관리됨 ❌

이미 추적중인 파일을 무시하고 싶다면 git rm --cached을 사용하여

git rm --cached 경로/파일명

git 관리 대상에서만 제거할수 있다 그다음 커밋한다

git commit -m "chore: stop tracking security.zip"

📋 커밋 전 체크리스트

커밋/푸시 전에 아래만 확인해도 실수가 많이 줄어든다

• git status에서 초록색 목록(커밋 대상) 에 내가 의도한 파일만 있는가 확인한다.
• zip, 로그, 임시파일 같은 것이 보이면
  • 지금 당장은 git restore --staged 파일경로로 제외한다.
  • 앞으로도 계속 생길 파일이면 .gitignore로 무시한다.
• 커밋 메시지는 팀 규칙에 맞춰 작성하고 git push로 업로드한다.