git tag --format

`git tag --format` 命令可以让你以指定的格式显示所有的 Git tag。它的常用选项有：

- `%n`: 表示换行符；
- `%d`: 表示 tag 的 ref 名称，相当于 `refs/tags/<tag-name>`；
- `%B`: 表示 tag 的注释。

示例：

git tag --format='%(refname:short) %(taggerdate:short) %(subject)' --sort=-taggerdate

这个命令会按照 tag 的创建时间（taggerdate），按照降序排序（最新的 tag 在前面），并以指定的格式显示每个 tag 的信息。其中：

- `%(refname:short)` 表示 tag 的名称；
- `%(taggerdate:short)` 表示 tag 的创建时间，格式为 `YYYY-MM-DD`；
- `%(subject)` 表示 tag 的注释。

你可以根据自己的需求调整格式和排序方式。

相关问题

git tag --format 用法

`git tag --format` 命令用于指定标签的格式。它可以让你自定义标签的输出格式，包括标签名、标签信息、标签作者、标签日期等信息。其基本用法如下：

git tag --format=<format>

其中 `<format>` 是一个字符串，用于定义标签的输出格式。该字符串中可以使用特定的占位符来表示不同的标签信息，例如：

- `%d`：表示标签所在的分支名称
- `%h`：表示标签所在的提交的短 SHA-1 值
- `%s`：表示标签的说明信息
- `%a`：表示标签的作者名称
- `%ai`：表示标签的创建时间（ISO 8601 格式）

例如，要显示标签名、标签说明信息和标签作者，可以使用以下命令：

git tag --format='%(tag) %(subject) %(author)'

该命令的输出类似于：

v1.0 Initial release John Smith <john@example.com>

你也可以在 `.git/config` 文件或者 `.gitattributes` 文件中指定默认的标签格式。例如，在 `.git/config` 文件中添加以下配置：

[format]
	tag = %(tag) %(subject) %(author)

这样，每次创建新标签时，都会自动使用该默认的标签格式。

git tag --format 详细用法

`git tag --format` 命令的详细用法如下。

### 命令语法

git tag --format=<format> [<tag-name>]

其中：

- `<format>`：用于指定标签输出格式的字符串。
- `<tag-name>`：可选参数，用于指定要显示的标签名称。如果省略该参数，则会显示所有标签的信息。

### 输出格式

`--format` 参数支持的占位符如下：

- `%n`：换行符。
- `%d`：标签所在的分支名称。
- `%D`：标签所在的分支名称（带有括号）。
- `%H`：标签所在的提交的 SHA-1 值。
- `%h`：标签所在的提交的短 SHA-1 值（7 位）。
- `%s`：标签说明信息。
- `%f`：标签所在的对象类型（commit、tree、blob、tag）。
- `%a`：标签的作者名称。
- `%ae`：标签的作者邮箱。
- `%ad`：标签的创建时间（RFC2822 格式）。
- `%ar`：标签的相对创建时间。
- `%at`：标签的创建时间戳。
- `%ai`：标签的创建时间（ISO 8601 格式）。
- `%c`：标签的提交者名称。
- `%ce`：标签的提交者邮箱。
- `%cd`：标签的提交时间（RFC2822 格式）。
- `%cr`：标签的相对提交时间。
- `%ct`：标签的提交时间戳。
- `%ci`：标签的提交时间（ISO 8601 格式）。
- `%G?`：标签是否已经被 GPG 签名（G：已签名；U：未签名）。
- `%g`：缩写的、可行的 Git 对象名；如果没有，则输出空字符串。
- `%v`：符合语义化版本规范的标签名称。

### 示例

#### 显示所有标签的信息

$ git tag --format="%(refname:short) %(taggerdate:short) %(subject)"
v1.0 2021-01-01 Initial release
v2.0 2021-02-01 Bug fixes
v3.0 2021-03-01 New features

该命令输出所有标签的名称、创建时间和说明信息。

#### 显示指定标签的信息

$ git tag --format="%(refname:short) %(taggerdate:short) %(subject)" v2.0
v2.0 2021-02-01 Bug fixes

该命令输出指定标签的名称、创建时间和说明信息。

#### 将格式设置为默认值

$ git config --global format.tag "%(refname) %(taggerdate:short) %(subject)"

该命令将输出格式设置为默认值，使得每次执行 `git tag` 命令时都会使用该默认格式。