English ▾ 主题 ▾ 最新版本 ▾ git-commit-tree 上次更新于 2.49.0

名称

git-commit-tree - 创建新的提交对象

概要

git commit-tree <tree> [(-p <parent>)…​]
git commit-tree [(-p <parent>)…​] [-S[<keyid>]] [(-m <message>)…​]
		  [(-F <file>)…​] <tree>

描述

通常，最终用户并不想直接运行此命令。请参阅 git-commit[1]。

基于提供的树对象创建一个新的提交对象，并在 stdout 上输出新的提交对象 ID。日志消息从标准输入读取，除非给定了 -m 或 -F 选项。

-m 和 -F 选项可以以任何顺序给出任意次数。提交日志消息将按照选项给出的顺序组成。

一个提交对象可以有任意数量的父对象。只有一个父对象时，它是一个普通的提交。有多个父对象使提交成为多个历史线之间的合并。初始（根）提交没有父对象。

虽然树表示工作目录的特定目录状态，但提交表示“时间”上的该状态，并解释如何到达该状态。

通常，提交会标识一个新的“HEAD”状态，虽然 Git 并不关心你在哪里保存有关该状态的注释，但在实践中，我们倾向于将结果写入 .git/HEAD 指向的文件，这样我们就可以始终看到上次提交的状态。

选项

<tree>

现有的树对象。

-p <parent>

每个 -p 指示父提交对象的 ID。

-m <message>

提交日志消息中的一个段落。可以多次给出，每个 <message> 都会成为其自己的段落。

-F <file>

从给定文件中读取提交日志消息。使用 - 从标准输入读取。可以多次给出，每个文件的内容都会成为其自己的段落。

-S[<keyid>]
--gpg-sign[=<keyid>]
--no-gpg-sign

GPG 签名提交。keyid 参数是可选的，默认为提交者身份；如果指定，则必须紧跟在选项后面，没有空格。--no-gpg-sign 用于取消命令行上较早给出的 --gpg-sign 选项。

提交信息

提交封装了

  • 所有父对象 ID

  • 作者姓名、电子邮件和日期

  • 提交者姓名和电子邮件以及提交时间。

提交注释从 stdin 读取。如果未通过“<”重定向提供变更日志条目，则 *git commit-tree* 将等待输入一个条目并以 ^D 结束。

日期格式

GIT_AUTHOR_DATE 和 GIT_COMMITTER_DATE 环境变量支持以下日期格式

Git 内部格式

它是 <unix-timestamp> <time-zone-offset>，其中 <unix-timestamp> 是自 UNIX 纪元以来的秒数。 <time-zone-offset> 是与 UTC 的正或负偏移量。例如，CET（比 UTC 早 1 小时）是 +0100。

RFC 2822

RFC 2822 描述的标准日期格式，例如 Thu, 07 Apr 2005 22:13:13 +0200。

ISO 8601

由 ISO 8601 标准指定的时间和日期，例如 2005-04-07T22:13:13。解析器也接受空格代替 T 字符。将忽略秒的小数部分，例如 2005-04-07T22:13:13.019 将被视为 2005-04-07T22:13:13。

注意
 此外，日期部分接受以下格式：YYYY.MM.DD、MM/DD/YYYY 和 DD.MM.YYYY。

讨论

Git 在某种程度上对字符编码不可知。

  • blob 对象的内容是未解释的字节序列。核心级别没有编码转换。

  • 路径名以 UTF-8 规范化形式 C 编码。这适用于树对象、索引文件、引用名称，以及命令行参数、环境变量和配置文件中的路径名 (.git/config (参见 git-config[1])、gitignore[5]、gitattributes[5] 和 gitmodules[5])。

    请注意，Git 在核心级别将路径名简单地视为非 NUL 字节序列，没有路径名编码转换（Mac 和 Windows 除外）。因此，即使在使用旧式扩展 ASCII 编码的平台和文件系统上，使用非 ASCII 路径名也大多可以正常工作。但是，在此类系统上创建的存储库在基于 UTF-8 的系统（例如 Linux、Mac、Windows）上将无法正常工作，反之亦然。此外，许多基于 Git 的工具只是假设路径名为 UTF-8，并且无法正确显示其他编码。

  • 提交日志消息通常以 UTF-8 编码，但也支持其他扩展 ASCII 编码。这包括 ISO-8859-x、CP125x 和许多其他编码，但 *不包括* UTF-16/32、EBCDIC 和 CJK 多字节编码（GBK、Shift-JIS、Big5、EUC-x、CP9xx 等）。

尽管我们鼓励提交日志消息以 UTF-8 编码，但核心和 Git 瓷器都被设计为不强制项目使用 UTF-8。如果特定项目的所有参与者都觉得使用旧式编码更方便，Git 不会禁止它。但是，需要记住以下几点。

  1. 如果给定的提交日志消息看起来不像有效的 UTF-8 字符串，则 git commit 和 git commit-tree 会发出警告，除非你明确声明你的项目使用旧式编码。要说明这一点，请在 .git/config 文件中包含 i18n.commitEncoding，如下所示

    [i18n]
	commitEncoding = ISO-8859-1

    使用上述设置创建的提交对象会在其 encoding 标头中记录 i18n.commitEncoding 的值。这是为了帮助以后查看它们的其他人。缺少此标头意味着提交日志消息以 UTF-8 编码。

  2. git log、git show、git blame 和相关命令会查看提交对象的 encoding 标头，并尝试将日志消息重新编码为 UTF-8，除非另有指定。你可以使用 .git/config 文件中的 i18n.logOutputEncoding 指定所需的输出编码，如下所示

    [i18n]
	logOutputEncoding = ISO-8859-1

    如果你没有此配置变量，则会改为使用 i18n.commitEncoding 的值。

请注意，我们有意选择不在进行提交时重新编码提交日志消息以强制在提交对象级别使用 UTF-8，因为重新编码为 UTF-8 不一定是可逆操作。

文件

/etc/mailname

另请参阅

git-write-tree[1] git-commit[1]

GIT

属于 git[1] 套件的一部分

scroll-to-top