Git 变更日志：如何获取特定标签的所有更改？

Question

有没有一种简单的方法或命令可以让所有 git 提交到特定标签来为项目生成自动变更日志？我总是使用 v0.1.0 之类的版本号来标记我的 git 存储库，例如希望所有提交都达到标记 v0.1.0。

我浏览了文档，但似乎没有找到有用的选项或命令： http://git- scm.com/docs/git-log （顺便说一句，目前已关闭）

例如：

$ git log --oneline --decorate

显示提交旁边的标签。我想要同样的，但仅限于特定标签。

Answer 1

您可以这样做：

git log --oneline --decorate v0.1.0

... 显示 v0.1.0 之前（包括 v0.1.0）的每个提交。当然， git log 还允许您限制以 git rev-list 理解的任何方式显示的提交，因此如果您只想查看之间的更改v0.0.9 和 v0.1.0 您也可以这样做：

git log --oneline --decorate v0.0.9..v0.1.0

可能对此目的有用的替代输出是 git Shortlog 的输出，它将并总结了每位作者的贡献。尝试一下，例如：

git shortlog v0.1.0

Answer 2

为了通过标签创建变更日志，我使用了这个脚本：

#!/bin/bash
# Author:Andrey Nikishaev
echo "CHANGELOG"
echo ----------------------
git tag -l | sort -u -r | while read TAG ; do
    echo
    if [ $NEXT ];then
        echo [$NEXT]
    else
        echo "[Current]"
    fi
    GIT_PAGER=cat git log --no-merges --format=" * %s" $TAG..$NEXT
    NEXT=$TAG
done
FIRST=$(git tag -l | head -1)
echo
echo [$FIRST]
GIT_PAGER=cat git log --no-merges --format=" * %s" $FIRST

Answer 3

有一个非常有用的gem，输出是用markdown编写的，添加问题支持并通过标签分割提交

https:// /github.com/kebab-project/katip

Answer 4

只需使用标签名称作为提交说明符：git log --oneline --decorate v0.1.0

Answer 5

对 Creotiv 建议的脚本进行更新，以更好地对标签进行排序

#!/bin/bash
# Author:Andrey Nikishaev, Gunnar Lindholm
echo "CHANGELOG"
echo ----------------------
git for-each-ref --sort='*authordate' --format='%(tag)' refs/tags |tac |grep -v '^
 | while read TAG ; do
     echo
    if [ $NEXT ];then
        echo [$NEXT]
    else
        echo "[Current]"
    fi
    GIT_PAGER=cat git log --no-merges --format=" * %s" $TAG..$NEXT
    NEXT=$TAG
done
FIRST=$(git tag -l | head -1)
echo
echo [$FIRST]
GIT_PAGER=cat git log --no-merges --format=" * %s" $FIRST

Answer 6

我对原始脚本进行了修改。这可以正确处理版本标签。

#!/bin/bash
# Author:Andrey Nikishaev
echo "CHANGELOG"
echo ----------------------
git tag -l --sort=v:refname | tac | while read TAG ; do
    echo
    if [ $NEXT ];then
        echo [$NEXT]
    else
        echo "[Current]"
    fi
    GIT_PAGER=cat git log --no-merges --format=" * %s" $TAG..$NEXT
    NEXT=$TAG
done
FIRST=$(git tag -l --sort=v:refname | head -1)
echo
echo [$FIRST]
GIT_PAGER=cat git log --no-merges --format=" * %s" $FIRST

Answer 7

只需将 tagname 附加到您的命令中就可以了:)我喜欢使用 --graph 开关来可视化导致该标记的分支:)

Answer 8

您可以使用 Git Changelog 命令行 来执行此操作：

npx git-changelog-command-line -std -tr v0.1.0 -tec "
# Changelog

Changelog for {{ownerName}} {{repoName}}.

{{#tags}}
## {{name}}
 {{#issues}}
  {{#hasIssue}}
   {{#hasLink}}
### {{name}} [{{issue}}]({{link}}) {{title}} {{#hasIssueType}} *{{issueType}}* {{/hasIssueType}} {{#hasLabels}} {{#labels}} *{{.}}* {{/labels}} {{/hasLabels}}
   {{/hasLink}}
   {{^hasLink}}
### {{name}} {{issue}} {{title}} {{#hasIssueType}} *{{issueType}}* {{/hasIssueType}} {{#hasLabels}} {{#labels}} *{{.}}* {{/labels}} {{/hasLabels}}
   {{/hasLink}}
  {{/hasIssue}}
  {{^hasIssue}}
### {{name}}
  {{/hasIssue}}

  {{#commits}}
**{{{messageTitle}}}**

{{#messageBodyItems}}
 * {{.}} 
{{/messageBodyItems}}

[{{hash}}](https://github.com/{{ownerName}}/{{repoName}}/commit/{{hash}}) {{authorName}} *{{commitTime}}*

  {{/commits}}

 {{/issues}}
{{/tags}}
"

Answer 9

使用 https://pypi.org/project/changelogfromtags/

pip install changelogfromtags && changelogfromtags

Answer 10

对一个指定标签使用此命令

git for-each-ref --format '%(contents)' refs/tags/v0.1.0

将 v.0.1.0 更改为所需标签