이 도구에 대해
Gitmoji는 Git의 기능이 아니라 커뮤니티 관례로, 커밋 메시지 앞에 의도를 한눈에 보여주는 이모지를 붙이는 방식입니다: ✨는 새 기능, 🐛는 버그 수정, 📝는 문서, ♻️는 리팩터링을 뜻하며, CI 변경부터 접근성 개선까지 다루는 약 70개의 이모지가 더 있습니다. gitmoji 접두어가 붙은 메시지로 가득한 `git log`를 훑어보면 각 줄을 다 읽지 않고도 어떤 작업이 있었는지 파악할 수 있고, 일부 팀은 이 이모지를 changelog 생성이나 semver 버전 상승에 직접 연결하기도 합니다.
이 치트시트는 공식 gitmoji 데이터셋의 모든 이모지를 `:code:` 짧은 코드, 설명, 대략적인 카테고리와 함께 나열하며, 검색하거나 카테고리로 필터링해 원하는 것을 빠르게 찾을 수 있게 해줍니다. 각 행에는 세 가지 복사 버튼이 있습니다: 이모지 자체, 붙여넣기 바로 가능한 끝 공백이 포함된 `:code:` 코드, 또는 터미널에 바로 붙여넣고 이어서 입력할 수 있는 전체 `git commit -m ":code: "` 줄입니다. 모든 처리는 브라우저에서 로컬로 실행되며 입력한 내용은 어디로도 전송되지 않습니다.
이것은 carloscuesta/gitmoji의 오픈소스 gitmoji 데이터(MIT 라이선스)를 기반으로 만든 독립적인 참고 자료입니다. 원 프로젝트와 제휴하거나 공인받은 것이 아닙니다 — 정식 목록과 공식 도구(CLI 및 IDE 확장 포함)는 gitmoji.dev에서 확인하세요.
자주 묻는 질문
gitmoji란 무엇인가요?
Gitmoji는 Git 커밋 메시지 앞에 이모지를 붙여 그 커밋이 어떤 종류의 변경인지 한눈에 알 수 있게 하는 커뮤니티 관례입니다 — 새 기능은 ✨, 버그 수정은 🐛, 문서는 📝 등입니다. 이는 Git의 기능도, 반드시 지켜야 하는 표준도 아니며, 일부 팀과 오픈소스 프로젝트가 커밋 이력을 더 쉽게 훑어보기 위해 채택한 명명 관례일 뿐입니다. 일부 워크플로에서는 changelog 생성이나 자동 semver 버전 상승에도 활용됩니다.
커밋 메시지에 gitmoji를 어떻게 사용하나요?
변경 내용에 맞는 gitmoji를 찾은 다음, 그 이모지(또는 GitHub 댓글처럼 짧은 코드를 렌더링하는 Git 호스트나 터미널을 쓴다면 `:code:` 짧은 코드)를 커밋 메시지 맨 앞에 두고 그 뒤에 짧은 설명을 붙입니다 — 예를 들어 `✨ Add dark mode toggle`이나 `:bug: Fix off-by-one error in pagination`처럼요. 이 도구의 "Commit" 복사 버튼은 전체 `git commit -m ":code: "` 명령을 만들어 주므로, 터미널에 바로 붙여넣고 나머지 메시지만 입력하면 됩니다.
이것은 공식 gitmoji 도구인가요?
아니요 — 이것은 Carlos Cuesta가 github.com/carloscuesta/gitmoji에 공개한 오픈소스 gitmoji 데이터(MIT 라이선스)를 기반으로 만든 독립적인 참고 자료입니다. 해당 프로젝트와 어떠한 제휴, 공인, 공식적 연관도 없으며, 기존 gitmoji 목록을 더 빠르게 검색하고 복사할 수 있게 하려는 목적으로만 존재합니다. 공식 목록, 공식 CLI, IDE 통합에 대해서는 gitmoji.dev를 참고하세요.
일부 gitmoji 옆에 있는 작은 'major/minor/patch' 표시는 무슨 뜻인가요?
이는 프로젝트가 semver를 따르고 커밋 이력으로부터 자동으로 버전을 올리는 경우, 해당 유형의 커밋이 의미하는 시맨틱 버저닝(semver) 상승 폭을 gitmoji 프로젝트가 제안한 것입니다 — 예를 들어 💥(boom)는 호환성이 깨지는 변경을 나타내므로 major를, ✨(sparkles)는 아무것도 깨지 않고 기능을 추가하므로 minor를 제안합니다. 📝(memo, 문서)처럼 많은 gitmoji는 버전 관련 의미가 전혀 없어 비워둡니다. 이를 반드시 따라야 하는 규칙이 아니라 유용한 힌트로 여기세요 — 많은 팀이 버전 자동화 없이 순전히 가독성을 위해 gitmoji를 사용합니다.