git describe

git describe：命令显示离当前提交最近的标签。该命令查找从提交可访问的最新标记。如果标签指向提交，则只显示标签。否则，它将标记名称与标记对象之上的其他提交数量以及最近提交的缩写对象名称后缀。

语法

git describe [--all] [--tags] [--contains] [--abbrev=<n>] [<commit-ish>…​]
git describe [--all] [--tags] [--contains] [--abbrev=<n>] --dirty[=<mark>]

默认情况下（不包括--all或--tags)。git describe只显示注释标签。

示例

如果符合条件的 tag 指向最新提交则只是显示 tag 的名字，否则会有相关的后缀来描述该 tag 之后有多少次提交以及最新的提交 commit id。不加任何参数的情况下，git describe只会列出带有注释的 tag。

git describe --tags
tag1-2-g026498b

显示结果含义：自打标签tag1以来有 2 次提交（commit）。