n1ro°
RU

Компьютеры · Инструкция

Как получить имя ближайшего тега через git describe

Для сборки и диагностики такая строка понятнее полного SHA и показывает положение коммита относительно релизного тега.

Редакция N1RO · Проверено

Короткий ответ

`git describe --tags --always <commit>` строит читаемое описание коммита от ближайшего достижимого тега или возвращает fallback-id.

Что делать

  1. Описать HEAD: Выполните `git describe --tags --always HEAD`.
  2. Указать другой ref: Замените HEAD на hash, branch или другой commit-ish.
  3. Сохранить полный вывод: В CI не отрезайте компоненты результата: они отражают расстояние и commit id.

Как понять, что получилось

  • Получена компактная строка, привязанная к ближайшему подходящему тегу либо fallback-идентификатору.

Что учесть

Shallow clone может не содержать истории и тегов, нужных для ожидаемого describe.

Что учитывать

Shallow clone может не содержать истории и тегов, нужных для ожидаемого describe.

Источники и проверка

Фактическая часть сверена по первичным источникам (в т.ч. git-describe). Пример и формулировки — редакция N1RO на 2026-09-18.