Git으로 인한 파일 누락 & 오류 해결 모음집

✅ Part 1. Git에 코드 일부만 올라간 문제

• 문제 상황: 로컬에서는 코드가 완성되어 있는데, GitHub에는 파일 일부만 올라감
• 원인 분석:
  1. git add를 하지 않아 추적되지 않은(untracked) 상태
  2. .gitignore 파일에 의해 특정 폴더나 파일이 무시됨
  3. VSCode에서 Git 변경사항 창에서 일부만 선택해 commit했음
• 해결 방법:

git status      # 어떤 파일이 누락됐는지 확인
git add .       # 전체 파일 스테이징
git commit -m "전체 파일 포함하여 커밋"
git push origin main

---

✅ Part 2. .gitignore 때문에 중요한 파일 누락

• 문제 상황: migrations/, .env, __pycache__/ 등 필요한 파일이 GitHub에 없음
• 원인 분석: .gitignore 파일에 해당 경로가 포함되어 있음
• 해결 방법:
  1. .gitignore 확인 후 필요하면 주석 처리
  2. 무시된 파일 강제 add

git add -f your_file_path

• 팁: 민감한 파일(.env 등)은 intentionally 무시하고 .env.example을 함께 공유

---

✅ Part 3. Git push 후 GitHub에는 최신 파일이 안 보일 때

• 문제 상황: push는 완료되었는데 GitHub에서 변경 내용이 보이지 않음
• 원인 분석:
  • 다른 브랜치에 push했거나
  • push가 오류로 실패했는데 성공한 줄 알았음
• 해결 방법:

git branch            # 현재 브랜치 확인
git log --oneline     # 마지막 커밋 확인
git push origin main  # main 브랜치에 정확히 push

---

✅ Part 4. Git 상에는 있는데 VSCode에서는 파일이 안 보임

• 문제 상황: GitHub에 있는 파일이 VSCode에서 안 보이거나 반대로 보임
• 원인 분석:
  • VSCode의 폴더 뷰와 Git 뷰가 다름
  • .gitkeep 없이 빈 폴더는 Git에서 무시됨
  • 최근 변경사항만 표시되도록 설정되어 있음
• 해결 방법:
  • VSCode에서 왼쪽 상단 Explorer 탭 클릭
  • 폴더를 직접 열어 전체 파일 확인
  • GitHub에서도 브랜치와 경로를 정확히 탐색

---

✅ Part 5. Git 충돌로 파일 사라진 줄 착각

• 상황: push 과정에서 merge conflict 발생 → 수동 해결 후 파일 일부가 사라짐
• 해결 방법:

git diff            # 변경된 내용 확인
git checkout -- file_name  # 실수로 지운 파일 복원

---

✅ 정리 포인트

프로젝트 중 Git을 통해 코드를 관리하면서, 예상치 못한 파일 누락 문제를 반복적으로 겪었습니다.
특히 .gitignore, git add 누락, 브랜치 착오, 충돌 처리 미숙 등 기본적인 Git 사용법에서의 작은 실수들이 실제 배포나 협업 과정에서 문제를 일으킨다는 점을 몸소 경험했습니다.
이를 통해 git status, git log, .gitignore의 중요성을 깊이 느꼈고, Git 작업 전 항상 변경 사항 확인 & 브랜치 점검을 습관화하게 되었습니다.