Об этом инструменте
Gitmoji — это соглашение сообщества, а не встроенная функция Git: перед сообщением коммита ставится эмодзи, которое сразу показывает суть изменения: ✨ для новой функции, 🐛 для исправления бага, 📝 для документации, ♻️ для рефакторинга и ещё около 70 других — от изменений CI до улучшений доступности. Просматривая `git log`, полный сообщений с префиксом-эмодзи, можно понять характер проделанной работы, не читая каждую строку, а некоторые команды напрямую связывают эмодзи с генерацией changelog или повышением версии semver.
Эта шпаргалка перечисляет все эмодзи из официального набора данных gitmoji вместе с кодом `:code:`, описанием и приблизительной категорией, и позволяет искать или фильтровать по категории, чтобы быстро найти нужный. У каждой строки есть три кнопки копирования: сам эмодзи, код `:code:` с пробелом в конце, готовый для вставки, или полная строка `git commit -m ":code: "`, которую можно вставить прямо в терминал и дописать сообщение. Всё выполняется локально в вашем браузере — ничего из введённого никуда не отправляется.
Это независимый справочник, построенный на открытых данных gitmoji из carloscuesta/gitmoji (лицензия MIT). Он не связан с оригинальным проектом и не одобрен им — актуальный список и официальные инструменты (включая CLI и расширения для IDE) смотрите на gitmoji.dev.
Частые вопросы
Что такое gitmoji?
Gitmoji — это соглашение сообщества, при котором перед сообщением коммита Git ставится эмодзи, сразу показывающее тип изменения — ✨ для новой функции, 🐛 для исправления бага, 📝 для документации и так далее. Это не встроенная функция Git и не обязательный стандарт; это просто соглашение об именовании, которое некоторые команды и open-source проекты используют, чтобы историю коммитов было легче просматривать, а в некоторых процессах — ещё и для генерации changelog или автоматического повышения версии semver.
Как использовать gitmoji в сообщениях коммитов?
Найдите gitmoji, соответствующий вашему изменению, и поставьте его эмодзи (или код `:code:`, если ваш git-хостинг или терминал отображает коды так же, как комментарии на GitHub) в самом начале сообщения коммита, а затем добавьте краткое описание — например, `✨ Add dark mode toggle` или `:bug: Fix off-by-one error in pagination`. Кнопка копирования «Commit» в этом инструменте формирует для вас полную команду `git commit -m ":code: "`, которую можно сразу вставить в терминал и дописать оставшуюся часть сообщения.
Это официальный инструмент gitmoji?
Нет — это независимый справочник, построенный на открытых данных gitmoji, опубликованных Карлосом Куэстой на github.com/carloscuesta/gitmoji (лицензия MIT). Он никак не связан с этим проектом, не одобрен и официально не аффилирован с ним; он существует только для того, чтобы ускорить поиск и копирование существующего списка gitmoji. Актуальный список, официальный CLI и интеграции с IDE смотрите на gitmoji.dev.
Что означает небольшая метка «major/minor/patch» рядом с некоторыми gitmoji?
Это повышение версии по семантическому версионированию (semver), которое, по мнению проекта gitmoji, подразумевает коммит такого типа — если ваш проект следует semver и автоматически повышает версию на основе истории коммитов. Например, 💥 (boom) предполагает major, так как сигнализирует о ломающем изменении, а ✨ (sparkles) — minor, поскольку добавляет функцию, ничего не ломая. Многие gitmoji, например 📝 (memo) для документации, вообще не несут версионного смысла и оставлены пустыми. Воспринимайте это как полезную подсказку, а не обязательное правило — многие команды используют gitmoji исключительно для удобства чтения, без какой-либо автоматизации версионирования.