[Git] 깃모지(gitmoji) 가이드

소프트웨어 개발을 할 때, 커밋 메시지는 팀 협업과 히스토리 추적에 있어 매우 중요한 역할을 담당한다. 그런데 원래 커밋 메시지는 텍스트 기반이라, ‘이 커밋이 어떤 종류의 변경을 담고 있는가?’를 한눈에 파악하기가 쉽지 않은 경우가 많다.
이런 문제를 해결하기 위해, 커밋 메시지에 **이모지(Emoji)**를 활용하여 쉽게 알아볼 수 있다. 그중 대표적인 예시가 깃모지(Gitmoji)다.

Gitmoji: 일관된 이모지 사용 규칙을 제공해, 커밋 메시지만 보고도 변경 사항의 의도를 쉽게 파악할 수 있도록 도와주는 프로젝트

1. 깃모지 사용 장점

1. 가독성:커밋 로그에서 이모지만 보고도 ‘버그 수정’인지 ‘문서 작성’인지 쉽게 알 수 있습니다.
2. 일관성:팀원들이 동일한 규칙(깃모지 표준)을 사용하면, 프로젝트 전반의 커밋 메시지가 일관성을 유지하게 됩니다.
3. 협업 효율:커밋 로그만 훑어보더라도 작업 종류가 빠르게 파악 가능해, PR 리뷰나 히스토리 추적이 쉬워집니다.

2. 깃모지 사용 방법

2.1 깃모지 CLI 설치 (선택 사항)

Gitmoji는 CLI(명령줄 도구)로 편리하게 사용할 수 있다. 꼭 CLI를 쓰지 않더라도, 이모지 코드를 직접 복사해 커밋 메시지에 붙여넣어도 무방하다.

# npm
npm install -g gitmoji-cli

# yarn
yarn global add gitmoji-cli

2.2 IDE에서 사용(권장)

나같은 경우는 IDE에서 바로 커밋을 한다. 그래서 IDE의 플러그인을 사용해서 깃모지를 사용한다.

1. VSCode: Gitmoji
2. IntelliJ: Gitmoji Plus

2.3 수동으로 사용(권장)

1. (1) 원하는 이모지를 복사한다 (예: :bug: → 실제 이모지는 🐛).
2. (2) git commit -m "🐛 fix: 버그를 수정했다" 와 같은 형식으로 작성한다.

Convention 예시:

:bug: → 실제 이모지는 🐛

커밋 메시지 헤더: 🐛 fix: ...

3. 전체 깃모지 표 & 사용 예시

아래 표는 공식 Gitmoji 레포지토리 혹은 gitmoji.dev에 올라온 표준 깃모지 목록이다.

각 깃모지가 의미하는 바, 그리고 어떤 상황에서 사용하는지 간단히 정리해두었다.

참고:

• 표에 나오는 “깃모지 코드”는 커밋 메시지에서 :sparkles: 같은 텍스트 형태로도 사용 가능하지만, 실제로는 ✨처럼 이모지로 변환된다.

Happy Gitmoji! ✨