[Git] Commit 메세지 규칙

Infra/Git

[Git] Commit 메세지 규칙

carsumin 2025. 11. 20. 22:07

커밋 메세지 규칙의 필요성

히스토리만 봐도 무슨 변경인지 바로 파악
협업 시 리뷰, 추적, 롤백이 쉬워짐
릴리즈 노트, 변경 이력 자동화 가능

커밋 메세지 기본 원칙

한 커밋 = 목적
무엇을 했는지 명확히 작성
왜 했는지는 필요할 때만
형식은 항상 동일하게

기본 형식

<type>(<scope>): <subject>

<body>

<footer>

필수
- type : 변경 종류
- subject : 한 줄 요약
선택
- scope : 영향 범위
- body : 변경 이유, 맥락
- footer : 이슈 번호, 브레이킹 체인지

Type 규칙

feat	새로운 기능 추가
fix	버그 수정
refactor	리팩토링 (기능 변화 없음)
docs	문서 수정
style	포맷, 세미콜론, 공백 등
test	테스트 코드
chore	빌드, 설정, 잡무
perf	성능 개선
ci	CI 설정
build	빌드 시스템 변경

예시

올바른 예시

feat(member): 회원 탈퇴 API 추가
fix(auth): refresh token 만료 검증 오류 수정
refactor(order): 주문 생성 로직 책임 분리

Scope 작성 기준
- 모듈/도메인 단위
- 팀에서 합의된 이름 사용
- 없으면 생략해도 됨

feat(member)
fix(payment)
refactor(common-security)

Footer (이슈 연동)

fix(order): 결제 금액 불일치 오류 수정

- 할인 적용 시 총액 계산 오류 수정

Closes #123

협업 시 정하면 좋은 추가 규칙

커밋 메세지 언어 (한글, 영어)
이슈 번호 필요 여부
squash merge 시 메시지 규칙
PR 제목 = 대표 커밋 메시지

저작자표시 비영리 변경금지 (새창열림)