Что такое Conventional Commits?

Conventional Commits — это лёгкая конвенция поверх обычных сообщений Git-коммитов, которая задаёт единый шаблон: <type>(<scope>): <description>. Такой формат делает историю изменений машиночитаемой: инструменты могут парсить коммиты, определять, какие изменения были добавлены, и на основе этого автоматически формировать версии и документацию.

Структура коммита

• type — тип изменения: feat (новая функциональность), fix (исправление бага), docs, style, refactor, test, chore и другие.
• scope — необязательная область изменений, например auth, api, ui.
• description — краткое описание в императиве, строчными буквами.
• body и footer — необязательные блоки для деталей и ссылок на issues, а также для указания breaking changes через BREAKING CHANGE:.

Примеры коммитов

feat(auth): add OAuth2 login via Google
fix(api): handle null response from payment service
docs(readme): update installation instructions
refactor(cart): extract price calculation into helper

feat(api)!: drop support for API v1

BREAKING CHANGE: endpoints /v1/* removed, use /v2/* instead

Как это применяется

На основе типов коммитов инструменты вроде semantic-release, standard-version или commitizen автоматически:

1. Определяют следующую версию по SemVer: fix — patch, feat — minor, BREAKING CHANGE — major.
2. Генерируют CHANGELOG.md с группировкой по типам.
3. Создают теги и релизы в CI/CD без ручного вмешательства.

Дополнительно конвенция улучшает читаемость истории: по git log --oneline сразу видно, что и зачем менялось, а code review и поиск регрессий становятся быстрее.

Итог: Conventional Commits стоит применять в командах и проектах, где важны автоматизация релизов, прозрачная история и генерация changelog — особенно в связке с CI/CD и semantic-release.