Что такое семантические коммиты?

Семантические коммиты — это соглашение о формате сообщений коммитов, которое позволяет автоматизировать процессы, связанные с релизом и формированием журнала изменений (changelog).

Формат сообщения: <тип>[Scope]: <описание>

• <тип>: Определяет характер изменений. Основные типы:
  • feat: Новая функциональность
  • fix: Исправление ошибки
  • docs: Изменения в документации
  • style: Изменения, не влияющие на логику кода (форматирование, пробелы и т.д.)
  • refactor: Изменения кода, не добавляющие функции и не исправляющие ошибки (реструктуризация)
  • test: Добавление или редактирование тестов
  • chore: Изменения, не влияющие на код или тесты (сборка, конфигурация)
• [Scope] (необязательно): Область или часть кодовой базы, которую затронули изменения. В круглых скобках.
• <описание>: Краткое, императивное описание изменений в настоящем времени.

Могут быть добавлены тело сообщения и футер для более детального описания или ссылок на задачи. BREAKING CHANGE в футере указывает на обратно несовместимые изменения.

Преимущества:

• Автоматическая генерация changelog.
• Определение типов релизов (patch, minor, major) на основе типов коммитов.
• Улучшение читаемости и понимания истории коммитов.
• Упрощение автоматизации (CI/CD).