🌿 중급 개발도구
커밋 메시지 컨벤션이 뭔가요?
쉽게 이해하기
일기를 쓸 때 '날씨 → 오늘 한 일 → 느낀 점' 순서로 쓰면 나중에 찾아보기 쉽듯이, 커밋 메시지도 '어떤 종류의 변경인지 → 무엇을 했는지' 형식으로 쓰면 나중에 히스토리를 파악하기 편합니다.
핵심 정리
커밋 메시지를 일관된 형식으로 작성하기 위한 규칙이에요.
자세히 알아보기
커밋 메시지 컨벤션은 Git 커밋 메시지를 일정한 형식으로 작성하는 규칙입니다. 팀 전체가 같은 규칙을 따르면 프로젝트 히스토리를 이해하기 쉽고, 자동화 도구로 변경 사항을 분류하거나 릴리스 노트를 생성할 수도 있습니다.
가장 널리 쓰이는 건 Conventional Commits입니다. 'feat: 로그인 기능 추가', 'fix: 회원가입 버그 수정', 'docs: README 업데이트' 같은 형식이죠. 앞에 붙는 타입(feat, fix, docs 등)으로 어떤 종류의 변경인지 바로 알 수 있습니다. chore는 빌드 설정 같은 자잘한 작업, refactor는 기능 변경 없이 코드 개선, test는 테스트 추가나 수정을 뜻합니다.
메시지는 현재형 동사로 시작하고('추가했다'가 아니라 '추가'), 50자 이내로 간결하게 쓰는 게 좋습니다. 본문이 필요하면 한 줄 띄우고 자세한 설명을 추가할 수 있어요. 예: 'fix: 결제 실패 시 에러 메시지 표시 안 되는 문제 수정'
이런 규칙을 따르면 나중에 'feat'으로 시작하는 커밋만 모아 어떤 기능이 추가됐는지 빠르게 파악할 수 있고, 자동으로 버전 번호를 올리거나 changelog를 생성하는 도구도 사용할 수 있습니다.