显示你在哪个 git 标签上？

编辑：Jakub Narębski 有更多的 git-fu。以下更简单的命令可以完美运行：

git describe --tags

（或者如果您已签出带注释的标签，则没有 --tags。我的标签是轻量级的，所以我需要 --tags。）

原答案如下：

git describe --exact-match --tags $(git log -n1 --pretty='%h')

拥有更多 git-fu 的人可能有更优雅的解决方案......

这利用了 git-log 从您签出的内容开始报告日志这一事实。 %h 打印缩写散列。然后 git describe --exact-match --tags 找到与该提交完全匹配的标签（轻量级或带注释的）。

上面的 $() 语法假定您使用的是 bash 或类似的。

---

这对我有用git describe --tags --abbrev=0

编辑 2020：正如下面的一些评论所提到的，这可能对你有用，也可能对你不起作用，所以要小心！

---

显示当前 HEAD（或提交）上的所有标签

git tag --points-at HEAD

---

git describe 是一个 porcelain 命令，您应该避免：

http://git-blame.blogspot.com/2013/06/checking-current-branch-programatically.html

相反，我使用了：

git name-rev --tags --name-only $(git rev-parse HEAD)

---

当您签出一个标签时，您会得到一个称为 "detached head" 的东西。通常，Git 的 HEAD 提交是指向您当前已签出的分支的指针。但是，如果您检查的不是本地分支（例如，标记或远程分支），那么您有一个“分离的头”——您实际上并不在任何分支上。你不应该在一个分离的头上进行任何提交。

如果您不想进行任何编辑，可以查看标签。如果您只是检查文件的内容，或者您想从标签构建您的项目，那么可以git checkout my_tag 处理这些文件，只要您不进行任何提交。如果你想开始修改文件，你应该基于标签创建一个分支：

$ git checkout -b my_tag_branch my_tag

将从 my_tag 开始创建一个名为 my_tag_branch 的新分支。在此分支上提交更改是安全的。

---

git log --decorate

这将告诉您哪些 refs 指向当前签出的提交。

---

对于一组特定的用例，这是一个有趣的例子。如果您的存储库有 v1.0.0、v1.1.0、v1.1.1 等版本，以及 v1 等指向最新 v1.x.x 的简写版本，以下将为您提供当前版本的参考-checked-out 提交与最新的完全版本化标签相关，如果这不起作用，则使用后备：

git describe --tags --exact-match --match "v*.*.*" \
  || git describe --match "v*.*.*" --tags \
  || git describe --tags \
  || git rev-parse HEAD

因此，假设您有以下提交：

* 4444444 (main, origin/main, tag: v2.0.0, tag: v2.0, tag: v2)
* 3333333
* 2222222 (tag: v1.1.0, tag: v1.1, tag: v1)
* 1111111 (tag: v1.0.0, tag: v1.0)
* 0000000

上面命令的一些示例 HEAD 的输出：

git checkout main -> v2.0.0

git checkout 3333333 -> v1.1.0-1-g3333333

git checkout 2222222 -> v1.1.0

git checkout v1 -> v1.1.0

git checkout 0000000 -> 0000000（完整参考）

---