Git 커밋 메시지 잘 쓰는 법

취미로 프로젝트를 하든, 팀 단위로 협업을 하든 커밋 메시지를 잘 남기는 것은 진짜 귀찮지만 중요한 일이다. 나중에 git log를 봤을 때도 바로바로 이해가 되고, 코드 리뷰할 때도 훨씬 편하다. 

 

제목 쓰는 방법

• 50자 이내로 짧고 명확하게
• 끝에 마침표 안 붙임
• 영어면 명령형 현재 시제 (Add, Fix, Update…)
• 한국어면 추가, 수정, 삭제 같은 간단한 동사 위주

 

본문 쓰는 방법

제목만으로 부족하면 본문에 적는다.

• 무엇을/왜 했는지 위주
• 어떻게 했는지는 코드 보면 알 수 있으니 생략

 

커밋 타입

Conventional Commits 방식 기준이다.

• feat: 새 기능
• fix: 버그 수정
• docs: 문서 변경
• style: 포맷/세미콜론/화이트스페이스 (로직 변경 없음)
• refactor: 리팩터링(동작 동일)
• perf: 성능 개선
• test: 테스트 추가/수정
• build: 빌드 시스템/의존성
• ci: CI 설정
• chore: 잡설정(코드 영향 없음)
• revert: 이전 커밋 되돌림