[Git] Gitmoji 커밋 메시지 가이드

📌 Gitmoji란?

Gitmoji는 Git 커밋 메시지에 이모지를 접두사로 사용해 변경 내용을 직관적이고 시각적으로 구분할 수 있도록 도와주는 표기법입니다.

예시:
✨ feat: 로그인 기능 추가
🐛 fix: 배포 시 환경 변수 오류 수정

---

🎯 왜 Gitmoji를 사용할까?

장점	설명
👀 가독성 향상	이모지를 통해 커밋 메시지가 한눈에 들어옴
🧭 목적 구분	커밋 타입을 명확하게 표현 가능
🤝 팀 협업	커밋 스타일을 일관성 있게 유지
📦 changelog 자동화	릴리즈 노트 도구와 쉽게 연동 가능

---

🚀 자주 사용하는 Gitmoji 목록

이모지	태그	설명
✨	feat:	새로운 기능 추가
🐛	fix:	버그 수정
♻️	refactor:	코드 리팩토링 (기능 변화 없음)
🔥	remove:	코드나 파일 제거
💄	style:	코드 포맷팅, 세미콜론 누락 등 스타일 수정
📝	docs:	문서 관련 작업 (README, 주석 등)
✅	test:	테스트 코드 추가/수정
🚀	perf:	성능 개선
🔧	chore:	빌드 설정, 패키지 설정 등 기타 작업
📦	build:	빌드 시스템 또는 의존성에 영향 주는 작업
🚨	lint:	린트 오류 수정
⬆️	deps:	의존성 업그레이드
⬇️	deps:	의존성 다운그레이드
🔀	merge:	브랜치 병합
🔖	release:	버전 태그

전체 목록은 공식 사이트 참고: https://gitmoji.dev

---

🛠 Gitmoji 사용하는 방법

1. 이모지를 복사해 직접 사용

git commit -m "✨ feat: 회원가입 기능 추가"

 

2. CLI 툴 사용 (gitmoji-cli)

npm install -g gitmoji-cli
gitmoji -c

• 실행하면 이모지를 선택하고 메시지를 입력할 수 있는 인터랙티브한 UI 제공

---

🧰 Gitmoji + 커밋 규칙 함께 쓰기

보통 Gitmoji는 Conventional Commit 스타일과 함께 사용합니다:

<이모지> <타입>: <간결한 설명>

예:
🐛 fix: 사용자 정보 저장 시 null 에러 해결
📦 build: Webpack 설정 변경

---

📁 예시 .gitmessage 템플릿

# <이모지> <타입>: <제목>
# 예) ✨ feat: 로그인 기능 구현

Git 설정에 등록:

git config --global commit.template ~/.gitmessag

---

🧩 마무리

Gitmoji는 단순한 장식이 아니라, 팀원들이 변경사항을 빠르게 파악하고 일관된 커밋 로그를 유지하는 데 도움을 줍니다.
프로젝트 규모가 커질수록 Gitmoji의 진가가 발휘됩니다 💪

---

💡 팀에 Gitmoji 사용 문화를 도입하고 싶다면 Notion이나 README에 위 내용을 포함시키는 것도 좋습니다.

 

참고자료:

https://gitmoji.dev

gitmoji

 

https://inpa.tistory.com/entry/GIT-%E2%9A%A1%EF%B8%8F-Gitmoji-%EC%82%AC%EC%9A%A9%EB%B2%95-Gitmoji-cli

⚡️ Gitmoji 사용법 정리 (+ 깃모지 툴 소개)

https://nowsun.tistory.com/146

[Git] 협업을 위한 커밋, 브랜치, PR 작성 규칙 정리