Git中文开发手册
简体中文(ZH-CN) English(EN) 繁体中文(ZH-TW) 日本語(JA) 한국어(KO) Melayu(MS) Français(FR) Deutsch(DE)
directory search
Guides gitattributes giteveryday gitglossary gitignore gitmodules gitrevisions gittutorial gitworkflows Administration git archive git bundle git clean git filter-branch git fsck git gc git instaweb git reflog Basic Snapshotting git add git commit git diff git mv git reset git rm git status Branching and Merging git branch git checkout git log git merge git mergetool git stash git tag Debugging git bisect git blame git grep Email git am git format-patch git request-pull git send-email External Systems git fast-import git svn Getting and Creating Projects git clone git init Git git annotate git archimport git bisect-lk2009 git check-attr git check-mailmap git check-ref-format git checkout-index git cherry git citool git column git credential git credential-cache git credential-store git cvsexportcommit git cvsimport git cvsserver git diff-files git diff-tree git difftool git fast-export git fetch-pack git fmt-merge-msg git get-tar-commit-id git gui git http-backend git http-fetch git http-push git imap-send git index-pack git interpret-trailers git ls-remote git ls-tree git mailinfo git mailsplit git merge-file git merge-index git merge-one-file git merge-tree git mktag git mktree git name-rev git notes git p4 git pack-objects git pack-redundant git pack-refs git parse-remote git patch-id git prune git prune-packed git quiltimport git receive-pack git remote-ext git remote-fd git remote-testgit git repack git replace git rerere git send-pack git sh-i18n git sh-setup git shell git show-branch git show-index git stripspace git unpack-file git unpack-objects git upload-archive git upload-pack git var git verify-commit git verify-tag git whatchanged git worktree Inspection and Comparison git describe git shortlog git show Miscellaneous api credentials api index gitcli gitcore tutorial gitcredentials gitcvs migration gitdiffcore githooks gitk gitnamespaces gitremote helpers gitrepository layout gitsubmodules gittutorial 2 gitweb gitweb.conf pack format User Manual Patching git apply git cherry-pick git rebase git revert Plumbing Commands git cat-file git check-ignore git commit-tree git count-objects git diff-index git for-each-ref git hash-object git ls-files git merge-base git read-tree git rev-list git rev-parse git show-ref git symbolic-ref git update-index git update-ref git verify-pack git write-tree Server Admin git daemon git update-server-info Setup and Config git git config git help Sharing and Updating Projects git fetch git pull git push git remote git submodule

©
This document uses PHP Chinese website manual Release

characters

名称

git-am  - 从邮箱应用一系列修补程序

概要

git am [--signoff] [--keep] [--[no-]keep-cr] [--[no-]utf8]         [--[no-]3way] [--interactive] [--committer-date-is-author-date]         [--ignore-date] [--ignore-space-change | --ignore-whitespace]         [--whitespace=<option>] [-C<n>] [-p<n>] [--directory=<dir>]         [--exclude=<path>] [--include=<path>] [--reject] [-q | --quiet]         [--[no-]scissors] [-S[<keyid>]] [--patch-format=<format>]         [(<mbox> | <Maildir>)…]git am (--continue | --skip | --abort)

描述

将邮箱中的邮件拆分为提交日志消息、作者信息和补丁，并将其应用到当前分支。

Options

(<mbox>|<Maildir>)…

要从中读取补丁的邮箱文件列表。如果您不提供此参数，则该命令会从标准输入中读取。如果你提供目录，他们将被视为邮件。

-s   --signoff

使用自己的提交者标识向提交消息添加Signed-off-by:一行。有关更多信息，请参阅 git-commit [1]中的 signoff 选项。

-k   --keep

将-k标志传递给git mailinfo（参见 git-mailinfo [1]）。

--keep-non-patch

将-b标志传递给git mailinfo（参见 git-mailinfo [1]）。

--no-keep-cr

用--keep-cr，使用相同的选项调用git mailsplit（请参阅 git-mailsplit [1]），以防止它在行尾剥离 CR。am.keepcr配置变量可以用来指定默认行为。--no-keep-cr对覆盖am.keepcr很有用。

-c   --scissors

在剪刀线前删除所有内容（参见 git-mailinfo [1]）。可以使用mailinfo.scissors配置变量默认激活。

--no-scissors

忽略剪刀线（参见 git-mailinfo [1]）。

-m   --message-id

将-m标志传递给git mailinfo（参见 git-mailinfo [1]），以便 Message-ID 头文件被添加到提交消息中。am.messageid配置变量可以用来指定默认的行为。

--no-message-id

不要将 Message-ID 头文件添加到提交消息中。no-message-id对覆盖am.messageid很有用。

-q   --quiet

保持安静。只打印错误消息。

-u   --utf8

将-u标志传递给git mailinfo（参见 git-mailinfo [1]）。建议的从电子邮件中提交的提交日志消息被重新编码为 UTF-8编码（i18n.commitencoding如果不是 UTF-8，配置变量可用于指定项目的首选编码）。

这在以前版本的 git 中是可选的，但现在它是默认的。您可以使用--no-utf8来覆盖此。

--no-utf8

将-n标志传递给git mailinfo（参见 git-mailinfo [1]）。

-3   --3way   --no-3way

如果修补程序不能干净地应用，如果修补程序记录它应该应用于的斑点的标识，则会退回到3路合并，并且我们在本地提供这些斑点。--no-3way可以用来覆盖 am.threeWay 配置变量。有关更多信息，请参阅g it-config [1]中的 am.threeWay。

--ignore-space-change   --ignore-whitespace   --whitespace=<option>   -C<n>   -p<n>   --directory=<dir>   --exclude=<path>   --include=<path>   --reject

这些标志被传递给git apply应用该补丁的（参见 git-apply [1]）程序。

--patch-format

默认情况下，该命令将尝试自动检测补丁格式。此选项允许用户绕过自动检测并指定补丁应被解释为的补丁格式。有效的格式是 mbox，mboxrd，stgit，stgit-series 和 hg。

-i   --interactive

以交互方式运行。

--committer-date-is-author-date

默认情况下，命令将来自电子邮件的日期记录为落实作者日期，并使用提交创建时间作为提交者日期。这允许用户通过使用与作者日期相同的值来说谎提交者日期。

--ignore-date

默认情况下，命令将来自电子邮件的日期记录为落实作者日期，并使用提交创建时间作为提交者日期。这允许用户通过使用与提交者日期相同的值来说谎作者日期。

--skip

跳过当前的补丁。这仅在重新启动中止的修补程序时才有意义。

-S<keyid>   --gpg-sign=<keyid>

GPG标志的提交。keyid参数是可选的，并且默认为提交者身份; 如果指定，它必须粘贴到选项没有空格。

--continue   -r   --resolved

修补程序失败后（例如尝试应用冲突修补程序），用户已手动应用它，并且索引文件存储应用程序的结果。使用作者身份并提交从电子邮件和当前索引文件提取的日志进行提交，然后继续。

--resolvemsg=<msg>

发生修补程序失败时，<msg>将在退出之前打印到屏幕上。这将覆盖标准消息，通知您使用--continue或--skip处理失败。这仅适用于git rebase和git am之间的内部使用。

--abort

恢复原始分支并中止修补操作。

讨论

提交作者姓名取自邮件的“From：”行，并且提交作者日期取自邮件的“Date：”行。在剥离普通前缀“PATCH <任何东西>”之后，“主题：”行用作提交的标题。“Subject：”这一行应该简洁地描述一行文本中提交的内容。

“From：”和“Subject：”开始主体的行会覆盖从头文件获取的各个提交作者名称和标题值。

提交消息由从“Subject:”取得的标题，空白行和消息的正文形成，直到补丁开始。每行末尾的多余空格将自动删除。

预计补丁将直接跟随消息内联。任何形式的行：

  • 三破折号和行尾，或者

  • 以“diff  - ”开头的行，或者

  • 以“Index：”开头的行作为补丁的开始，并且提交日志消息在第一次出现此行之前终止。初次调用时git am，您将其指定要处理的邮箱名称。在看到不适用的第一个补丁后，它会在中间中止。您可以通过以下两种方法之一从中恢复：

  • 通过使用该--skip选项重新运行该命令，跳过当前的修补程序。

  1. 手动解决工作目录中的冲突，并更新索引文件，使其进入补丁应该产生的状态。然后使用该--continue选项运行该命令。

在当前操作完成之前，命令拒绝处理新邮箱，因此如果您决定从头开始，请git am --abort在运行带有邮箱名称的命令之前运行。

在应用任何补丁之前，ORIG_HEAD 被设置为当前分支的顶端。如果您在多次提交时遇到问题，比如git am在错误的分支上运行，或者通过更改邮箱（例如，“发件人：”行中的错误）更容易修复提交中的错误，则这很有用。

Hooks

这个命令可以运行applypatch-msg，pre-applypatch以及post-applypatch挂钩。有关更多信息，请参阅 githooks [5]。

Previous article： Next article：