저장소와 커밋
5. 자주 하는 실수 (Tip)
❌ 실수 1. .gitignore 만 추가하면 끝이라고 생각
.gitignore 는 아직 추적하지 않는 파일에만 적용됩니다. 이미 커밋된 파일은 git rm --cached 로 따로 빼야 합니다.
❌ 실수 2. git add . 를 습관적으로 사용
폴더 전체를 무심코 add 하면 로그, 빌드 산출물, 임시 파일까지 딸려 들어갑니다. .gitignore 를 먼저 정비하고 git status -s 로 무엇이 올라가는지 확인한 뒤 add 합니다.
❌ 실수 3. git commit -am 이 새 파일도 포함한다고 착각
-am 은 이미 추적 중인 파일의 수정만 자동 add 합니다. untracked 새 파일은 git add 를 따로 해야 커밋에 들어갑니다.
❌ 실수 4. 커밋 메시지에 "수정", "업데이트"만 남김
몇 달 뒤 git log --oneline 을 봐도 무엇을 바꿨는지 알 수 없습니다. 제목에 무엇을, 필요하면 본문에 왜를 적습니다.
❌ 실수 5. git diff 와 git diff --staged 를 혼동
add 한 변경은 git diff 에 나오지 않습니다. add 이후에도 변경이 보이지 않으면 --staged 를 빼먹은 것인지 확인합니다.
❌ 실수 6. 큰 바이너리 파일을 실수로 커밋
target/*.class, 빌드 산출물, IDE 설정 폴더는 처음부터 .gitignore 에 넣습니다. 저장소 크기가 커지면 나중에 정리하기가 훨씬 번거롭습니다.
❌ 실수 7. git rm 과 git rm --cached 를 혼동
git rm 은 작업 트리 파일까지 지웁니다. 파일은 남기고 추적만 그만두려면 반드시 --cached 를 붙입니다.
❌ 실수 8. 커밋 하나에 서로 다른 작업을 섞음
버그 수정과 새 기능을 한 커밋에 담으면 나중에 되돌리기가 어렵습니다. git add -p 로 나눠 커밋하거나 작업 단위로 커밋을 쪼갭니다.
❌ 실수 9. git status 결과를 확인하지 않고 커밋
commit 전에 git status -s 로 무엇이 스테이징됐는지 항상 확인합니다. 의도하지 않은 파일이 섞이는 실수를 커밋 전에 잡을 수 있습니다.
❌ 실수 10. 해시를 손으로 옮겨 적다 오타
커밋 해시는 앞 7~8자만으로도 대부분 구분됩니다. git show 해시 대신 git log --oneline 결과를 복사해 붙여넣는 편이 안전합니다.