커밋 메시지는 팀과 사람마다 스타일이 다릅니다. 형식이 제각각 쌓이면 히스토리를 읽는 데 시간이 오래 걸립니다. 이를 줄이는 간단한 방법은 커밋 메시지 앞에 접두사(prefix)를 붙이는 것입니다. 예를 들어 다음처럼 작성합니다.
fix: resolve emoji rendering issue in chat window
이 한 줄만 봐도 버그 수정이라는 맥락을 바로 알 수 있습니다. 커밋 메시지에 일관된 접두사를 쓰면 히스토리를 훑으며 각 커밋의 변경 종류를 빠르게 파악할 수 있습니다. 팀원과 소통하거나 코드 리뷰와 릴리즈 노트를 작성할 때도 도움이 됩니다. 자주 쓰는 접두사를 정리해 보겠습니다.
커밋 접두사 규칙 (Conventional Commit Prefixes)
가장 자주 사용하는 접두사
feat: feature, 새로운 기능 추가fix: 버그 수정refactor: 동작 변경 없이 코드 구조 개선docs: documentation, 문서 수정test: 테스트 추가 또는 수정chore: 기타 유지보수 작업
추가로 알아두면 좋은 접두사
style: 코드 포맷 변경 (로직 변경 없음)perf: performance, 성능 개선build: 빌드 시스템 또는 의존성 변경ci: continuous integration, CI/CD 설정 변경revert: 이전 커밋 되돌리기
사용 예시
feat: add churn prediction pipeline
fix: handle missing values in dataset
refactor: simplify feature engineering logic
perf: reduce training time with randomized search
docs: update README with usage instructions
test: add unit tests for encoder_helper