🔥 깃허브 커밋 메시지 규칙 정리

깃허브에서 자주 사용되는 커밋 메시지 규칙을 정리해보겠습니다.

📝 커밋 메시지 기본 구조

type: subject

body

footer

📌 자주 사용되는 타입(type)

• 🎉 feat: 새로운 기능 추가
• 🐛 fix: 버그 수정
• 📖 docs: 문서 변경
• 🎨 style: 코드 포맷팅, 세미콜론 누락 등 (코드 변경 없음)
• 🔧 refactor: 코드 리팩토링 (기능 변경 없음)
• 🧪 test: 테스트 코드 추가/수정 (기능 변경 없음)
• 🏗️ chore: 빌드 프로세스 혹은 문서 생성 도구 등의 변경 (기능 변경 없음)
• ⚡ perf: 성능 개선 관련 변경 사항
• 🤖 ci: CI 설정 및 스크립트 변경
• 🏗 build: 빌드 시스템 변경 사항 (예: 패키지 매니저 변경)
• ⏪ revert: 이전 커밋을 되돌릴 때 사용

✍️ 제목(subject) 작성 규칙

• 50자 이내로 작성
• 첫 글자는 대문자로 시작
• 마침표로 끝내지 않음
• 명령문으로 작성 (과거형 X)
• "어떤 변경을 했는가?"에 초점을 맞춤

📝 본문(body) 작성 규칙

• 선택사항 (필수 아님)
• "무엇을" 변경했는지보다 "왜" 변경했는지 설명
• 72자 단위로 줄바꿈
• 주요 변경 사항을 여러 줄로 나누어 상세히 설명 가능
• 필요하면 코드 블록( )을 사용하여 예제 제공 가능

🔖 꼬리말(footer) 작성 규칙

• 선택사항 (필수 아님)
• 이슈 트래커 ID 참조 시 사용
• 예: Closes #123, Fixes #456, Resolves #789
• 브레이킹 체인지(Breaking Changes)가 있을 경우 BREAKING CHANGE:를 포함하여 설명

✅ 실제 예시

🎉 feat: 사용자 로그인 기능 추가

소셜 로그인 및 이메일 인증 방식 모두 구현
사용자 경험 향상을 위해 자동 로그인 옵션 추가

Resolves: #123

🐛 fix: 로그인 시 발생하는 버그 수정

JWT 토큰이 만료된 경우 자동으로 갱신되지 않는 문제 해결
기존의 세션 기반 인증을 유지하면서 토큰 기반 인증을 보완

Fixes: #456

⚠️ breaking change: API 응답 형식 변경

기존 응답 형식에서 `user` 객체를 `data` 필드 내부로 이동
해당 변경으로 인해 기존 클라이언트 코드 수정 필요

BREAKING CHANGE: API 응답 형식이 변경됨에 따라 이전 버전과 호환되지 않음