Git如何保存预设的git log --format

Question

我真的很喜欢简短的 git 日志格式，我可以在其中看到作者、日期和更改描述，如下所示：

git log --pretty=format:"%h%x09%an%x09%ad%x09%s"

哪些输出：

  fbc3503 mads    Thu Dec 4 07:43:27 2008 +0000   show mobile if phone is null...   
  ec36490 jesper  Wed Nov 26 05:41:37 2008 +0000  Cleanup after [942]: Using timezon
  ae62afd tobias  Tue Nov 25 21:42:55 2008 +0000  Fixed #67 by adding time zone supp
  164be7e mads    Tue Nov 25 19:56:43 2008 +0000  fixed tests, and a 'unending appoi

（来自stackoverflow问题“link text”）

现在的问题是，如何在我的机器上将其保存为新格式，这样我只需要编写类似的内容，例如：

git log --format=jespers_favourite

Answer 1

在较新版本的 Git（已通过 v1.7.8 确认）中，可以使用 git config pretty.named_format 设置 命名的漂亮打印日志格式。这些可以使用<file-option> 参数在机器范围、用户或文件级别进行设置。

要创建名为jespers_favourite 的日志格式或整机使用--system

git config --system pretty.jespers_favourite "%h%x09%an%x09%ad%x09%s"

对于单用户使用'--global'

git config --global pretty.jespers_favourite "%h%x09%an%x09%ad%x09%s"

将<file-option> 参数留空将默认设置当前存储库的配置文件.git/config，除非另有定义。

Answer 2

考虑到 git log 手册页提到：

--pretty[=<format>]
--format[=<format>]

以给定的格式漂亮地打印提交日志的内容，其中可以是 oneline、short、medium、full、fuller、email、raw 和 format: 之一。省略时，格式默认为中。

<format> 只能有预定义的值。
这只会让您有可能将define an alias 作为该命令的快捷方式。

[alias]
        jespers_favourite = log --pretty=format:"%h%x09%an%x09%ad%x09%s"

或

[alias]
        compactlog = log --pretty=format:"%h%x09%an%x09%ad%x09%s"

Answer 3

您可以使用 git-config 配置默认的漂亮格式。来自 git-config 文档：

 format.pretty
           The default pretty format for log/show/whatchanged command, See git-log(1), git-show(1), git-whatchanged(1).

例如：

git config --add format.pretty fuller

或原始海报所需的格式：

git config --add format.pretty "%h%x09%an%x09%ad%x09%s"

与其他 git config 设置一样，format.pretty 可以设置在全局、系统或存储库范围（默认）。

Answer 4

使用最新版本的 git（此处为 1.7…2.21），您可以将默认格式更改为命名格式或格式字符串。当你这样做的时候，你也可以添加一些PRETTY FORMATS 自动颜色。我还发现编辑文件比使用命令更容易；但我先从他们开始，先获得正确的配置文件格式，然后再修补。

默认更改为：

git config --global --add format.pretty \
"%C(yellow)%h%Creset%x09%Cred%<(13)%an%Creset%x09%Cblue%ad%Creset%x09%s"

导致添加到您的.gitconfig 中：

[format]
    pretty = %C(yellow)%h%Creset%x09%Cred%<(13)%an%Creset%x09%Cblue%ad%Creset%x09%s

但是，添加命名格式可能对您更有用，如问题后面部分所述。

一个命名格式被添加：

git config --global pretty.dateline \
"format:%C(yellow)%h%Creset%x09%Cred%<(13)%an%Creset%x09%Cblue%ad%Creset%x09%s"

或者通过添加到您的.gitconfig 为：

[pretty]
    dateline = format:%C(yellow)%h%Creset%x09%Cred%<(13)%an%Creset%x09%Cblue%ad%Creset%x09%s

结合使用：

如果你同时添加两者，你可以让它们阅读：

[pretty]
    dateline = format:%C(yellow)%h%Creset%x09%Cred%<(13)%an%Creset%x09%Cblue%ad%Creset%x09%s

[format]
    pretty = dateline

注意事项：

应该注意format:前缀的区别，我个人喜欢将默认的漂亮格式保留为medium。如您所知，%ad 部分可以通过--date=relative 或default、iso8601、local、raw、relative、rfc2822、short 中的任何一个进行修改；所以我喜欢这样使用它：

git log -25 --pretty=dateline --date=short -- when/was/this/changed.txt