[GitHub] Gitmoji

⚡️ Gitmoji란?

• Git + Emoji = Gitmoji
• Git 커밋 메시지에 이모지를 사용하는 커밋 스타일 가이드
• 커밋의 의미를 직관적으로 나타내며
  협업 시에 커밋 히스토리를 더 가독성 있게 정리할 수 있게 도와줌

✅ Gitmoji의 목적

• 커밋 내용을 이모지로 한눈에 파악 가능
• 커밋 메시지를 의미별로 분류하여 구조화
• 협업 시 커밋 로그를 읽기 쉽고 재미있게
  
  

🏷️ Gitmoji의 분류와 의미

🔧 기능 개발 및 유지 보수 관련

이모지	설명	예시
✨ :sparkles:	새로운 기능 추가	✨ 다크모드 기능 추가
🐛 :bug:	버그 수정	🐛 로그인 시 에러 수정
♻️ :recycle:	리팩토링	♻️ 조건문 단순화
🚑 :ambulance:	긴급 패치 (hotfix)	🚑 빌드 실패 수정

📄 문서 관련

이모지	설명	예시
📄 :page_facing_up:	문서 추가 또는 수정	📄 README 업데이트
📝 :memo:	문서 오타/간단 수정	📝 문서 내 오타 수정

🔧 설정 및 인프라

이모지	설명	예시
🔧 :wrench:	설정 파일 수정	🔧 Prettier 설정 추가
🐳 :whale:	Docker 관련 작업	🐳 Docker Compose 구성 추가
🔒 :lock:	보안 관련 변경	🔒 비밀번호 암호화 추가

📦 패키지 및 빌드

이모지	설명	예시
📦 :package:	패키지 추가/업데이트	📦 lodash 설치
⬆️ / ⬇️	패키지 업/다운그레이드	⬆️ axios 버전 업그레이드
🛠️ :hammer_and_wrench:	빌드 시스템 관련 작업	🛠️ Webpack 설정 변경

✅ 테스트 및 배포

이모지	설명	예시
✅ :white_check_mark:	테스트 코드 추가/수정	✅ 회원가입 테스트 추가
🚀 :rocket:	배포 관련 작업	🚀 1.0.0 버전 배포
🧪 :test_tube:	실험적 코드 추가	🧪 GraphQL API 실험 적용

🔀 기타

이모지	설명	예시
🔀 :twisted_rightwards_arrows:	브랜치 병합	🔀 feature/login 병합
🔥 :fire:	코드 제거	🔥 사용하지 않는 import 삭제
👷 :construction_worker:	CI 작업	👷 GitHub Actions 추가
🗃️ :card_file_box:	DB 관련 작업	🗃️ 마이그레이션 스크립트 추가

🛠️ 사용 예시

git commit -m "✨ 사용자 회원가입 기능 추가"
git commit -m "🐛 비밀번호 유효성 검사 오류 수정"
git commit -m "📄 README에 사용 예시 추가"

→ VSCode 등의 커밋 도구에서는 직접 이모지를 붙여도 됨

📚 Gitmoji의 장점 vs 주의할 점

✅ 장점

• 커밋 로그가 한눈에 보이고 시각적
• 팀 간 커뮤니케이션 비용 감소
• 나중에 git log 분석할 때 분류가 쉬움
• 실수 줄이고 일관된 커밋 스타일 유지

⚠️ 주의할 점

• 이모지 선택이 통일되지 않으면 혼란
• 너무 많은 이모지 사용은 오히려 노이즈가 될 수 있음
• 팀원 간 컨벤션 사전 합의 필수
• Gitmoji 사용이 목적이 아니라 가독성과 구조화가 핵심

---

🔗 참고 사이트

• Gitmoji 공식 웹사이트
• VSCode Gitmoji 확장
• Gitmoji CLI GitHub