본문 바로가기
TIP

협업의 시작은 커밋 메시지부터! Conventional Commits 완벽 가이드

by 프론트엔드마스터일걸 2026. 3. 26.
728x90
반응형

 

협업 할 때 마구잡이로 커밋을 하게 된다면 나중에 다시 코드를 찾을 때 협업자도 본인도 찾아보기 쉽지않다.

 

실제 현업에서 여러 프로젝트를 동시에 진행하게 됐을 때 Stash에 잠깐 올려두었다가 코드가 너무 쌓여서

임시 커밋을 했는데 .... 여러사람이 이런방식으로 깨작깨작 올리니까 임시커밋이 꽤나 쌓이더라^^...

 

회사마다 정해진 규칙이 있겠지만,

이번 공부를 통해 대체적으로 많이 쓰인다는 관습적 커밋규격이 따로 있다는걸 알게됐다.

 

관습적 커밋이란

마치 도서관의 책들을 장르별로 분류하듯, 수많은 커밋 내역을 한눈에 파악하기 위해 전 세계 개발자들이 약속한 '말머리' 정도라고 보면된다.

 

자주 사용하는 말머리 종류

말머리(Type) 의미 사용 예시
feat Feature. 새로운 기능 추가 feat: 뉴스 스와이프 애니메이션 구현
fix Bug Fix. 버그 수정 fix: 로그인 버튼 클릭 안되는 현상 수정
docs Documentation. 문서 수정(README 등) docs: 설치 방법 설명 추가
style Style. 코드 의미에 영향 없는 수정(세미콜론, 포맷팅) style: Tailwind 클래스 순서 정리
refactor Refactor. 기능은 그대로인데 코드 구조만 개선 refactor: 중복되는 API 호출 로직 제거
test Test. 테스트 코드 추가 및 수정 test: 회원가입 유효성 검사 테스트 추가
chore chore. 빌드 업무, 패키지 매니저 설정 등 잡일 chore: capacitor 라이브러리 설치

 

728x90
반응형