Git

Git 브랜치 이름 & 커밋 메시지 규칙

Damdadira 2025. 6. 18. 16:39

협업을 하다 보면 개발자마다 자신만의 스타일이 있다.

팀 프로젝트에서는 이런 다양함이 혼란의 원인이 되곤 한다.

여러 사람이 함께 코드를 작성하고, 기록을 남기는 상황에서는 작업 방식에 대한 규칙을 정하는 것이 매우 중요하다.

그중 브랜치 이름커밋 메시지만 통일해도 다른 사람이 코드를 읽거나 변경 이력을 추가할 때 훨씬 수월해진다.

 

 

 

브랜치 이름 규칙
  • 모두 소문자로 작성하는 것이 일반적
  • 소문자 + 하이픈(-)
<타입>/<기능-설명>
타입 설명
feature/feat 새로운 기능 개발
fix 버그 수정
style 스타일 관련 수정
refactor 리팩토링
hotfix 긴급 수정
chore 빌드, 설정, 문서 등 유지보수성 변경
test 테스트 코드 관련 작업
release 배포 관련 작업

 

예시

  • feat/login
  • fix/login-button
  • style/login-button

 

 

 

커밋 메시지 규칙
  • 모두 소문자로 작성하는 것이 일반적
  • 소문자 + 설명
  • 설명을 작성할 때는 대소문자 상관없이 자유롭게 작성해도 된다.
<타입>: <작업 내용 요약>
타입 설명
feat 새로운 기능 추가
fix 버그 수정
docs 문서 수정
style 스타일 수정
refactor 코드 리팩토링 작업
test 테스트 코드 작업
chore 빌드 설정, 패키지 변경 등 기타 작업
perf 성능 향상 관련 작업
ci CI 설정 변경 작업
build 빌드 시스템 관련 변경 작업
revert 이전 커밋으로 되돌리는 작업

 

예시

  • feat: 로그인 API 연동
  • fix: 로그인 버튼 클릭 오류 수정
  • docs: README에 프로젝트 설명 추가
  • style: 로그인 버튼 색상 변경
  • refactor: 회원가입 유효성 검사 로직 개선