为什么 GitHub 邀请我输入两条提交消息而不是一条？答案

【问题标题】：Why does GitHub invite me to enter two commit messages instead of just one?为什么 GitHub 邀请我输入两条提交消息而不是一条？
【发布时间】：2014-09-30 22:20:39
【问题描述】：

这可能是一个基本问题，但我认为值得一问。在 GitHub 上，当您通过单击加号将文件添加到存储库时在存储库名称旁边签名，您会看到一个文本区域，您可以在其中输入文件的内容，然后是两个提交消息：

但是，当我使用git commit -m 时，我只能指定一个消息。因此我的困惑......

GitHub 上的可选扩展描述 是否最终在存储库中？克隆有问题的 GitHub 存储库后，我将如何查看此类消息？

据我所知，git commit 只允许您指定一条消息（使用 -m 标志），但也许我遗漏了一些东西。有没有办法指定第二个 扩展消息，不知何故？

【问题讨论】：

标签： git github commit git-commit

【解决方案1】：

TL;DR

[...] 两个提交消息[...]？

两个？！不;只有一个。这两个文本字段的内容组合起来产生一个单个提交消息。 GitHub 使用两个文本字段而不是一个仅用于诱骗用户正确格式化他们的提交消息。

详情

git-commit 手册页有一个标题为讨论的部分，其中包含有关提交消息的首选格式的以下准则：

虽然不是必需的，但最好以提交消息开头一个简短的（少于 50 个字符）行总结更改，后跟一个空行，然后是更详尽的描述。这提交消息中直到第一个空行的文本被视为提交标题，并且该标题在整个 Git 中使用。

当用户要直接在 GitHub 站点上创建提交时，她会被邀请填写两个文本字段：

第一个文本字段对应于总结更改的单个短（少于 50 个字符）行。
第二个文本字段对应于更详尽的描述。

通过提供两个文本字段而不是一个，GitHub 帮助用户遵循规定的提交消息策略。请特别注意，如果在第一个对话框中键入的字符数超过 50，您会收到一条警告消息：

如果您随后在本地 repo 中运行 git fetch 和 git log，您将看到提交消息由两个文本字段的内容组成：

$ git log
commit 0ef92f231cfbf2d4faf8f006e8ba19fc8169c099
Author: Jubobs xxxxxxxxxxxxxx
Date:   Wed Oct 1 10:39:15 2014 +0100

    write 'Hello, World!'

    - foo
    - bar
    - baz

【讨论】：

【解决方案2】：

好的，我已经使用“git clone”克隆了 GitHub 存储库通过运行“git log”或“git commit --amend”我现在可以看到该消息由第一个 50 个字符的提交消息行，后跟一个空格后跟可选的扩展消息。

谢谢。

【讨论】：

【解决方案3】：

GitHub 在“GUIfying”许多 Git 操作方面做得非常出色。

正如您所说，'git -m "message here" 将提供所谓的“短消息”，并在您使用 git log 时显示为标题。

但是，git 支持更多的文本 - 作为提交的一部分存储。这就是 GitHub 在第二个编辑字段中为您提供的内容；有机会向提交消息添加更多细节。当您在本地拥有存储库时（由于git clone），如果您修改日志输出（例如git log --pretty==fuller），您可以看到“额外”数据。

【讨论】：