[138+] 깃Git 커밋 메시지 작성하기 feat refactor

오늘은 어제에 이어서 노동을 하였다.

오늘 끝날줄 알았는데 생각보다 많아서 한참 남았다.... 하지만! 알아가는 것이 또 하나 있즤

 

커밋을 하려고 내용을 뭐라고 적을지 생각하고 있었는데 다른 대리님들이 쓴 커밋 내용이 눈에 들어왔다.

그래서 매번 [제목] 내용 이렇게 적었었는데(마스터에 내가 바로 올리는게 아니라 대리님께서 올려주셔서)

나도 똑같이 적어보기로 했다. 그래서 챗 선생님께 물어봄

 

git 커밋 메시지

커밋 메시지, 왜/어떻게 쓰나?

1) 개념

커밋 메시지는 “이번 변경으로 무엇을, 왜 했는지”를 짧고 명확하게 기록하는 메모예요.
좋은 커밋 메시지는:

• 리뷰어가 변경 의도를 빠르게 이해하게 하고
• 나중에 히스토리를 검색/추적하기 쉽게 만들며
• 자동 릴리즈 노트/체인지로그/버저닝(semver)에 활용될 수 있어요.

2) 타입(종류)

팀 컨벤션(Angular + 이모지)에 맞춰 주로 쓰는 타입들입니다.

• ✨ feat: 새로운 기능/코드 추가
• 🐛 fix: 버그 수정
• ♻️ refactor: 기능 변화 없이 코드 구조/가독성/유지보수성 개선
• 🧹 chore: 빌드/툴링/잡무(코드 동작에 영향 X)
• 📝 docs: 문서 수정(README, 주석 등)
• 🎨 style: 포맷팅/스타일(세미콜론, lint fix 등; 로직 변화 X)
• ✅ test: 테스트 추가/수정
• ⚡ perf: 성능 개선
• 🏗️ build: 빌드 시스템/외부 의존성 변경
• ⚙️ ci: CI 구성/스크립트 변경
• ⏪ revert: 이전 커밋 되돌림

참고: 타입은 “변경의 성격”으로 선택하세요. “무엇을 바꿨는가”가 아니라 “왜 바꿨는가(의도)”가 기준입니다.

3) 스코프(scope) 정하기

괄호 안에 변경 영역을 적어 대상 범위를 빠르게 알 수 있게 해요.

• 예: (pdfViewer), (adjudication), (common-code), (config), (eslint)
• 너무 넓게(core)도, 너무 좁게(utils/date/format/parse)도 말고 컴포넌트/모듈/도메인 단위가 좋아요.
• 팀에서 주로 쓰는 폴더/도메인 이름으로 일관성 있게!

4) 메시지 형식 (팀 스타일 반영)

기본 구조

 

<이모지> <타입>(<스코프>): <한글 요약>, <영문 요약>

[본문 - 선택적]
왜 이 변경을 했는지, 어떤 배경이 있었는지, 상세 내용

[푸터 - 선택적]
관련 이슈 번호, 브레이킹 체인지, Co-authored-by 등

---

예시 1 — 기능 추가 (feat)

✨ feat(user-auth): 로그인 API 추가, add login API
- JWT 기반 로그인 엔드포인트 구현
- 성공/실패 시 응답 구조 정의

---

예시 2 — 버그 수정 (fix)

🐛 fix(cart): 수량 계산 오류 수정, fix quantity calculation bug
- 수량이 0일 때 합계 금액이 음수가 되던 문제 해결

---

예시 3 — 코드 리팩토링 (refactor)

♻️ refactor(payment): 결제 모듈 구조 개선, refactor payment module structure
- 중복된 결제 검증 로직 공통 함수로 분리
- 변수명 정리 및 주석 추가

 

👉 이런 식으로, 타입(type) + 스코프(scope) + 요약(한글, 영어) 조합을 맞추고, 필요할 때 본문과 푸터를 보강하면 됩니다.

 

Git 커밋 메시지는 왜 중요할까? | InfoGrab, DevOps 전문 기술 기업 | 인포그랩 | GitLab기반 DevSecOps 구축,컨설팅,교육,기술지원 서비스 제공

Git 커밋 메시지는 왜 중요할까?

 

 

따라서 이모티콘과 함께 의도에 맞춰서 메시지를 작성하면 된다. 나도 오늘 마지막에 feat, refactor 써봤다. 히히!

 

커밋...커밋...ㅋㅋ