简体中文 ▾ 主题 ▾ 最新版本 ▾ 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]。

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

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

一个提交对象可以有任意数量的父对象。只有一个父对象的提交是普通提交。拥有多个父对象则表示该提交是多条历史线的合并。初始（根）提交没有父对象。

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

通常，一次提交会标识一个新的“HEAD”状态，尽管 Git 不关心你将该状态的注释保存在何处，但在实践中，我们通常将结果写入 .git/HEAD 指向的文件中，这样我们就可以始终看到最后一次提交的状态。

选项

<树对象>

一个已存在的树对象。

-p <父对象>

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

-m <消息>

提交日志消息中的一个段落。这可以多次给定，每个 <消息> 都会成为一个独立的段落。

-F <文件>

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

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

对提交进行 GPG 签名。keyid 参数是可选的，默认为提交者身份；如果指定，它必须紧跟选项，中间不能有空格。--no-gpg-sign 用于取消命令行中较早给定的 --gpg-sign 选项。

提交信息

一个提交封装了

  • 所有父对象的ID

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

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

提交注释从标准输入读取。如果没有通过“<”重定向提供变更日志条目，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 在核心层面将路径名简单地视为非空字节序列，除了在 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 核心和 Git Porcelain 都被设计为不强制项目使用 UTF-8。如果特定项目的所有参与者觉得使用传统编码更方便，Git 不会禁止。但是，有几点需要记住。

  1. git commit 和 git commit-tree 如果收到的提交日志消息看起来不像有效的 UTF-8 字符串，就会发出警告，除非您明确说明您的项目使用传统编码。指定此项的方法是在 .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