실전 팁

명령어를 안다고 Git을 잘 쓰는 것은 아닙니다. 좋은 습관이 협업을 편하게 만들고, 사고를 막아 줍니다. 이 마지막 강좌에서 실무에서 통하는 원칙과 자주 하는 실수를 정리합니다.

학습 목표

• 좋은 커밋 메시지를 쓴다.
• .gitignore로 불필요한 파일을 제외한다.
• 작은 단위로 자주 커밋한다.
• 흔한 실수와 그 예방법을 안다.

좋은 커밋 메시지

커밋 메시지는 미래의 나와 동료를 위한 기록입니다. 일반적인 규칙은 다음과 같습니다.

• 첫 줄(제목)은 50자 내외로 무엇을 했는지 요약한다.
• 제목은 명령형으로 간결하게(예: "추가한다"보다 "추가").
• 자세한 배경·이유가 있으면 한 줄 띄고 본문에 적는다.

# 나쁜 예
git commit -m "수정"
git commit -m "ㅁㄴㅇㄹ"

# 좋은 예
git commit -m "로그인 실패 시 에러 메시지 노출"

본문까지 적는 경우(에디터가 열림):

결제 금액 반올림 오류 수정

소수점 둘째 자리에서 잘못 버림 처리되어 1원 차이가 나던 문제를
Math.round 기준으로 통일. 관련 이슈 #42

.gitignore — 추적하지 않을 파일

빌드 산출물, 의존성 폴더, 비밀 키, 로그 등은 저장소에 올리면 안 됩니다. 프로젝트 루트에 .gitignore 파일을 만들어 제외 규칙을 적습니다.

# 의존성
node_modules/

# 빌드 산출물
dist/
build/

# 환경 변수 / 비밀
.env
*.key

# 로그 / 캐시
*.log
.DS_Store

⚠️ 이미 커밋·추적 중인 파일은 .gitignore에 추가해도 무시되지 않습니다. 추적에서 빼려면 캐시에서 제거해야 합니다.

git rm --cached .env       # 추적만 해제(파일은 남김)
git commit -m ".env 추적 제외"

특히 비밀번호·API 키가 담긴 .env 같은 파일은 커밋하기 전에 반드시 .gitignore에 넣어 두세요. 한 번 push하면 이력에 영구히 남습니다.

작은 단위로 자주 커밋

하나의 커밋은 하나의 논리적 변경만 담는 것이 좋습니다.

• 무엇이 바뀌었는지 메시지로 명확히 설명된다.
• 문제가 생긴 커밋을 찾아 그것만 되돌리기 쉽다.
• 코드 리뷰가 쉬워진다.

"로그인 기능 + 디자인 변경 + 오타 수정"을 한 커밋에 몰아넣지 말고, 의미 단위로 나눠 커밋합니다. 한 번에 다 못 정했다면 파일·라인 단위로 골라 스테이징할 수도 있습니다.

git add -p     # 변경을 조각(hunk) 단위로 골라 스테이징

자주 하는 실수와 주의점

• 메인 브랜치에서 직접 작업 — 항상 작업 브랜치를 만들어 작업하세요.
• push 후 reset/rebase로 이력 변경 — 공유된 커밋은 git revert로 되돌리세요.
• reset --hard 남용 — 커밋 안 한 변경이 영구 삭제됩니다. 실행 전 한 번 더 확인.
• pull 없이 push — push 전 git pull로 원격 최신을 먼저 합치세요.
• 비밀 정보 커밋 — .env·키 파일은 .gitignore로 미리 제외.
• 거대한 커밋 — 작은 단위로 나누고 메시지를 명확히.

혹시 실수로 커밋을 잃은 것 같다면, Git은 웬만한 작업 기록을 남겨 둡니다.

git reflog     # HEAD 가 거쳐 온 기록 — 잃은 커밋 해시를 찾아 복구 가능

요약

좋은 Git 습관은 곧 좋은 협업 습관입니다. 메시지는 명확히, 커밋은 작게 자주, 불필요·민감 파일은 .gitignore로 제외하고, 공유된 이력은 revert로 안전하게 다룹니다. 이 원칙들을 지키면 Git이 든든한 안전망이 되어 줍니다. 강좌를 마치며, 이제 직접 저장소를 만들어 손에 익혀 보세요.