简体中文 ▾ 主题 ▾ 最新版本 ▾ git-send-email 最后更新于 2.53.0

名称

git-send-email - 以电子邮件形式发送一组补丁

概要

git send-email [<options>] (<file>|<directory>)…​
git send-email [<options>] <format-patch-options>
git send-email --dump-aliases
git send-email --translate-aliases

描述

获取命令行中给出的补丁并将其通过电子邮件发送出去。补丁可以指定为文件、目录（将发送目录中的所有文件）或直接指定为修订列表。在最后一种情况下，任何 git-format-patch[1] 接受的格式以及 git-format-patch[1] 能理解的选项都可以传递给 git send-email。

电子邮件的标头可通过命令行选项配置。如果未在命令行中指定，将通过支持 ReadLine 的界面提示用户提供必要信息。

补丁文件接受两种格式

  1. mbox 格式文件

    这是 git-format-patch[1] 生成的格式。大多数标头和 MIME 格式会被忽略。

  2. Greg Kroah-Hartman 的 send_lots_of_email.pl 脚本所使用的原始格式

    此格式要求文件的第一行包含 Cc: 值，第二行包含邮件的 Subject:（主题）。

选项

撰写

--annotate

检查并编辑您即将发送的每个补丁。默认值为 sendemail.annotate 的配置值。有关 sendemail.multiEdit 的信息，请参阅“配置”部分。

--bcc=<地址>,…​

为每封邮件指定 Bcc:（密送）值。默认值为 sendemail.bcc 的配置值。

此选项可以指定多次。

--cc=<地址>,…​

为每封邮件指定起始 Cc:（抄送）值。默认值为 sendemail.cc 的配置值。

此选项可以指定多次。

--compose

调用文本编辑器（参见 git-var[1] 中的 GIT_EDITOR）为补丁序列编辑一条说明性邮件。

使用 --compose 时，git send-email 将使用邮件中指定的 From、To、Cc、Bcc、Subject、Reply-To 和 In-Reply-To 标头。如果邮件正文（在标头和空行之后输入的内容）仅包含空行（或以 Git: 为前缀的行），则不会发送摘要，但除非删除，否则将使用上述标头。

如果缺少 From 或 In-Reply-To 标头，系统将提示输入。

有关 sendemail.multiEdit 的信息，请参阅“配置”部分。

--from=<地址>

指定电子邮件的发送者。如果未在命令行中指定，则使用 sendemail.from 配置选项的值。如果命令行选项和 sendemail.from 均未设置，则会提示用户输入。提示的默认值将是 git var -l 返回的 GIT_AUTHOR_IDENT 的值，若未设置则使用 GIT_COMMITTER_IDENT。

--reply-to=<地址>

指定收件人回复应发送到的地址。如果邮件的回复应发送到与 --from 参数指定的地址不同的地址，请使用此选项。

--in-reply-to=<标识符>

使第一封邮件（或在使用 --no-thread 时为所有邮件）显示为对给定 Message-ID 的回复，从而避免因提供新的补丁系列而中断线程。第二封及后续邮件将根据 --[no-]chain-reply-to 设置作为回复发送。

例如，当指定 --thread 和 --no-chain-reply-to 时，第二封及后续补丁将作为对第一封补丁的回复，如下图所示，其中 [PATCH v2 0/3] 是对 [PATCH 0/2] 的回复。

[PATCH 0/2] Here is what I did...
  [PATCH 1/2] Clean up and tests
  [PATCH 2/2] Implementation
  [PATCH v2 0/3] Here is a reroll
    [PATCH v2 1/3] Clean up
    [PATCH v2 2/3] New tests
    [PATCH v2 3/3] Implementation

仅在同时设置了 --compose 时才需要。如果未设置 --compose，系统将提示输入。

--outlook-id-fix
--no-outlook-id-fix

Microsoft Outlook SMTP 服务器会丢弃通过电子邮件发送的 Message-ID，并分配一个新的随机 Message-ID，从而破坏邮件线程。

配合 --outlook-id-fix，git send-email 使用 Outlook 服务器特有的机制来获取服务器分配的 Message-ID 以修复线程。仅当您确定服务器报告重写的 Message-ID 的方式与 Outlook 服务器一致时才使用此选项。

如果未指定此选项，在与 smtp.office365.com 或 smtp-mail.outlook.com 通信时默认会进行修复。即使与这两个服务器通信，也可以使用 --no-outlook-id-fix 来禁用此功能。

--subject=<字符串>

指定邮件线程的初始主题。仅在同时设置了 --compose 时才需要。如果未设置 --compose，系统将提示输入。

--to=<地址>,…​

指定生成的电子邮件的主要收件人。通常，这将是相关项目的上游维护者。默认值为 sendemail.to 配置值；如果未指定且未指定 --to-cmd，则会提示输入。

此选项可以指定多次。

--8bit-encoding=<编码>

当遇到未声明编码的非 ASCII 邮件或主题时，添加标头/引用以表明其使用 <编码> 编码。默认值为 sendemail.assume8bitEncoding；如果未指定，且遇到任何非 ASCII 文件，则会提示输入。

请注意，系统不会尝试验证该编码的有效性。

--compose-encoding=<编码>

指定撰写邮件的编码。默认值为 sendemail.composeEncoding；如果未指定，则默认为 UTF-8。

--transfer-encoding=(7bit|8bit|quoted-printable|base64|auto)

指定通过 SMTP 发送邮件时使用的传输编码。7bit 在遇到非 ASCII 邮件时会失败。quoted-printable 在仓库包含含有回车符的文件时很有用，但会使原始补丁邮件文件（从 MUA 保存的）更难手动检查。base64 更加万无一失，但也更加不透明。auto 将在可能时使用 8bit，否则使用 quoted-printable。

默认值为 sendemail.transferEncoding 配置值；如果未指定，默认为 auto。

--xmailer
--no-xmailer

添加（或防止添加）X-Mailer: 标头。默认情况下会添加此标头，但可以通过将 sendemail.xmailer 配置变量设置为 false 来将其关闭。

发送

--envelope-sender=<地址>

指定用于发送电子邮件的信封发件人。如果您的默认地址不是订阅列表的地址，这将非常有用。要使用 From 地址，请将值设置为 auto。如果您使用 sendmail 二进制文件，您必须拥有使用 -f 参数的适当权限。默认值为 sendemail.envelopeSender 配置变量的值；如果未指定，则由您的 MTA 选择信封发件人。

--sendmail-cmd=<命令>

指定发送电子邮件时运行的命令。该命令应类似于 sendmail；具体而言，它必须支持 -i 选项。如有必要，该命令将在 shell 中执行。默认值为 sendemail.sendmailCmd。如果未指定，且也未指定 --smtp-server，则 git send-email 将在 /usr/sbin、/usr/lib 和 $PATH 中搜索 sendmail。

--smtp-encryption=<加密方式>

指定 SMTP 连接开始加密的方式。有效值为 ssl 和 tls。任何其他值将恢复为普通（未加密）的 SMTP，默认端口为 25。尽管名称如此，这两个值都将使用较新版本的 TLS，但由于历史原因保留了这些名称。ssl 指的是“隐式”加密（有时称为 SMTPS），默认使用 465 端口。tls 指的是“显式”加密（通常称为 STARTTLS），默认使用 25 端口。SMTP 服务器可能会使用其他非默认端口。常见的 tls 和未加密的替代端口是 587。您需要查看提供商的文档或服务器配置以确定您的情况。默认值为 sendemail.smtpEncryption。

--smtp-domain=<FQDN>

指定在发送给 SMTP 服务器的 HELO/EHLO 命令中使用的完全限定域名 (FQDN)。某些服务器要求 FQDN 与您的 IP 地址匹配。如果未设置，git send-email 会尝试自动确定您的 FQDN。默认值为 sendemail.smtpDomain。

--smtp-auth=<机制>

允许的 SMTP-AUTH 机制列表，以空格分隔。此设置强制仅使用列出的机制。例如

$ git send-email --smtp-auth="PLAIN LOGIN GSSAPI" ...

如果指定的机制中至少有一个与 SMTP 服务器宣告的机制匹配，并且所使用的 SASL 库支持该机制，则使用该机制进行身份验证。如果既未指定 sendemail.smtpAuth 也未指定 --smtp-auth，则可以使用 SASL 库支持的所有机制。可以指定特殊值 none 以完全禁用身份验证，而不管是否指定了 --smtp-user。

--smtp-pass[=<密码>]

SMTP-AUTH 的密码。该参数是可选的：如果未指定参数，则使用空字符串作为密码。默认值为 sendemail.smtpPass，但 --smtp-pass 总是会覆盖此值。

此外，密码无需在配置文件或命令行中指定。如果已指定用户名（通过 --smtp-user 或 sendemail.smtpUser），但未指定密码（通过 --smtp-pass 或 sendemail.smtpPass），则会使用 git-credential[1] 获取密码。

--no-smtp-auth

禁用 SMTP 身份验证。--smtp-auth=none 的简写。

--smtp-server=<主机>

指定要使用的外发 SMTP 服务器（例如 smtp.example.com 或原始 IP 地址）。如果未指定，且也未指定 --sendmail-cmd，则默认在 /usr/sbin、/usr/lib 和 $PATH 中搜索 sendmail（如果此类程序可用），否则回退到 localhost。

为了向后兼容，此选项也可以指定类似 sendmail 程序的完整路径名；该程序必须支持 -i 选项。此方法不支持传递参数或使用普通命令名称。对于这些用例，请考虑改用 --sendmail-cmd。

--smtp-server-port=<端口>

指定与默认端口不同的端口（SMTP 服务器通常监听 25 端口，但也可能监听 587 端口或常见的 SSL SMTP 端口 465）；也接受符号端口名称（例如用 submission 代替 587）。端口也可以通过 sendemail.smtpServerPort 配置变量进行设置。

--smtp-server-option=<选项>

指定要使用的外发 SMTP 服务器选项。默认值可以通过 sendemail.smtpServerOption 配置选项指定。

对于您想要传递给服务器的每个选项，必须重复使用 --smtp-server-option 选项。同样，配置文件中的每个选项必须使用不同的行。

--smtp-ssl

--smtp-encryption ssl 的旧版别名。

--smtp-ssl-cert-path <路径>

用于 SMTP SSL/TLS 证书验证的可信 CA 证书库路径（可以是经 c_rehash 处理的目录，或者是包含一个或多个 PEM 格式证书的单个文件：有关这些内容的更多信息，请参见 https://docs.openssl.org/master/man1/openssl-verify/ [OpenSSL 的 verify(1) 手册页] 中 -CAfile <文件> 和 -CApath <目录> 选项的描述）。将其设置为空字符串可禁用证书验证。如果已设置，则默认为 sendemail.smtpSSLCertPath 配置变量的值，否则为底层 SSL 库的编译默认值（这在大多数平台上应该是最佳选择）。

--smtp-user=<用户>

SMTP-AUTH 的用户名。默认值为 sendemail.smtpUser 的值；如果未指定用户名（通过 --smtp-user 或 sendemail.smtpUser），则不会尝试身份验证。

--smtp-debug=(0|1)

启用 (1) 或禁用 (0) 调试输出。如果启用，将打印 SMTP 命令和响应。对于调试 TLS 连接和身份验证问题非常有用。

--imap-sent-folder=<文件夹>

某些电子邮件提供商（例如 iCloud）不会将使用 SMTP 发送的邮件副本保存到您邮箱中的 Sent（已发送）文件夹或类似文件夹。使用此选项可以通过 git imap-send 将邮件副本发送到此选项指定的文件夹。您可以运行 git imap-send --list 来获取有效文件夹名称列表，包括您邮箱中 Sent 文件夹的正确名称。您还可以使用此选项将邮件发送到您选择的专用 IMAP 文件夹。

此功能需要设置 git imap-send。有关说明，请参阅 git-imap-send[1]。

--use-imap-only
--no-use-imap-only

如果设置此项，所有电子邮件将仅被复制到通过 --imap-sent-folder 或 sendemail.imapSentFolder 指定的 IMAP 文件夹中，而不会发送给收件人。如果您只想创建电子邮件草稿并使用另一个电子邮件客户端发送它们，这将非常有用。如果使用 --no-use-imap-only 禁用，电子邮件将正常发送。默认禁用，但可以使用 sendemail.useImapOnly 配置变量来启用它。

此功能需要设置 git imap-send。有关说明，请参阅 git-imap-send[1]。

--batch-size=<数量>

某些电子邮件服务器（例如 smtp.163.com）限制每个会话（连接）发送的电子邮件数量，这会导致在发送大量邮件时失败。通过此选项，send-email 将在发送 <数量> 封邮件后断开连接，等待几秒钟（参见 --relogin-delay）并重新连接，以规避此类限制。您可能希望使用某种形式的凭据助手，以避免每次发生这种情况时都要重新输入密码。默认值为 sendemail.smtpBatchSize 配置变量。

--relogin-delay=<秒数>

重新连接 SMTP 服务器前等待 <秒数> 秒。与 --batch-size 选项配合使用。默认值为 sendemail.smtpReloginDelay 配置变量。

自动化

--no-to
--no-cc
--no-bcc

清除之前通过配置设置的所有 To:、Cc:、Bcc: 地址列表。

--no-identity

清除之前通过配置读取的 sendemail.identity 值（如果有）。

--to-cmd=<命令>

指定一个每个补丁文件执行一次的命令，该命令应生成补丁文件特定的 To: 条目。此命令的输出必须是每行一个电子邮件地址。默认值为 sendemail.toCmd 配置值。

--cc-cmd=<命令>

指定一个每个补丁文件执行一次的命令，该命令应生成补丁文件特定的 Cc: 条目。此命令的输出必须是每行一个电子邮件地址。默认值为 sendemail.ccCmd 配置值。

--header-cmd=<命令>

指定一个每条外发消息执行一次的命令，并输出 RFC 2822 风格的标头行，以便插入到消息中。设置 sendemail.headerCmd 配置变量后，始终使用其值。当在命令行提供 --header-cmd 时，其值优先于 sendemail.headerCmd 配置变量。

--no-header-cmd

禁用任何正在使用的标头命令。

--chain-reply-to
--no-chain-reply-to

如果设置此项，每封邮件都将作为对前一封发送邮件的回复发送。如果使用 --no-chain-reply-to 禁用，第一封之后的所有邮件都将作为对第一封发送邮件的回复。使用此选项时，建议给出的第一个文件是整个补丁系列的概述。默认禁用，但可以使用 sendemail.chainReplyTo 配置变量来启用它。

--identity=<身份>

配置身份。指定时，会导致 sendemail.<身份> 子部分中的值优先于 sendemail 部分中的值。默认身份是 sendemail.identity 的值。

--signed-off-by-cc
--no-signed-off-by-cc

如果设置此项，则将 Signed-off-by 尾注或 Cc: 行中找到的电子邮件添加到抄送列表。默认值为 sendemail.signedOffByCc 配置值；如果未指定，默认为 --signed-off-by-cc。

--cc-cover
--no-cc-cover

如果设置此项，补丁系列中第一个补丁（通常是自述信）的 Cc: 标头中找到的电子邮件将被添加到每封发送邮件的抄送列表中。默认值为 sendemail.ccCover 配置值；如果未指定，默认为 --no-cc-cover。

--to-cover
--no-to-cover

如果设置此项，补丁系列中第一个补丁（通常是自述信）的 To: 标头中找到的电子邮件将被添加到每封发送邮件的收件人列表中。默认值为 sendemail.toCover 配置值；如果未指定，默认为 --no-to-cover。

--suppress-cc=<类别>

指定额外的收件人类别以抑制自动抄送：

  • author 将避免包含补丁作者。

  • self 将避免包含发送者。

  • cc 将避免包含补丁标头 Cc 行中提到的任何人，除了自己（为此请使用 self）。

  • bodycc 将避免包含补丁正文（提交说明）Cc 行中提到的任何人，除了自己（为此请使用 self）。

  • sob 将避免包含 Signed-off-by 尾注中提到的任何人，除了自己（为此请使用 self）。

  • misc-by 将避免包含补丁正文中提到的 Acked-by、Reviewed-by、Tested-by 和其他“-by”行中的任何人，但 Signed-off-by 除外（为此请使用 sob）。

  • cccmd 将避免运行 --cc-cmd。

  • body 等同于 sob + bodycc + misc-by。

  • all 将抑制所有自动抄送值。

默认值为 sendemail.suppressCc 配置值；如果未指定，且指定了 --suppress-from，则默认为 self；如果指定了 --no-signed-off-cc，则还包括 body。

--suppress-from
--no-suppress-from

如果设置此项，不要将 From: 地址添加到 Cc: 列表。默认值为 sendemail.suppressFrom 配置值；如果未指定，默认为 --no-suppress-from。

--thread
--no-thread

如果设置此项，In-Reply-To 和 References 标头将被添加到每封发送的邮件中。每封邮件是指向前一封邮件（按 git format-patch 的措辞为 deep 深度线程）还是指向第一封邮件（shallow 浅层线程）由 --[no-]chain-reply-to 决定。

如果通过 --no-thread 禁用，则不会添加这些标头（除非通过 --in-reply-to 指定）。默认值为 sendemail.thread 配置值；如果未指定，默认为 --thread。

当要求 git send-email 添加 In-Reply-To 标头时，用户需确保该标头尚不存在（特别注意 git format-patch 可以配置为自行进行线程化）。如果不这样做，可能会在收件人的 MUA 中产生非预期的结果。

--mailmap
--no-mailmap

使用 mailmap 文件（参见 gitmailmap[5]）将所有地址映射到其规范的真实姓名和电子邮件地址。可以使用 sendemail.mailmap.file 或 sendemail.mailmap.blob 配置值提供特定于 git send-email 的额外 mailmap 数据。默认为 sendemail.mailmap。

管理

--confirm=<模式>

在发送前确认：

  • always 发送前始终确认。

  • never 发送前从不确认。

  • cc 当 send-email 自动将补丁中的地址添加到抄送列表时，在发送前确认。

  • compose 使用 --compose 时，在发送第一条消息前确认。

  • auto 等同于 cc + compose。

默认值为 sendemail.confirm 配置值；如果未指定，默认为 auto，除非指定了任何 suppress 选项，在这种情况下默认为 compose。

--dry-run

执行除实际发送电子邮件以外的所有操作。

--format-patch
--no-format-patch

当一个参数既可以理解为引用也可以理解为文件名时，选择将其理解为 format-patch 参数 (--format-patch) 或文件名 (--no-format-patch)。默认情况下，当发生此类冲突时，git send-email 将报错失败。

--quiet

减少 git send-email 的详细程度。每封电子邮件应仅输出一行。

--validate
--no-validate

对补丁执行健全性检查。目前，验证意味着以下内容：

  • 如果存在 sendemail-validate 钩子，则调用它（见 githooks[5]）。

  • 除非使用了合适的传输编码（auto、base64 或 quoted-printable），否则对包含超过 998 个字符的行的补丁发出警告；这是由于 https://www.ietf.org/rfc/rfc5322.txt 中描述的 SMTP 限制。

默认值为 sendemail.validate；如果未设置，默认为 --validate。

--force

即使安全检查会阻止，也发送电子邮件。

信息

--dump-aliases

不执行常规操作，而是从配置的别名文件中转储简写别名，每行一个，按字母顺序排列。注意，这仅包括别名，不包括其展开后的电子邮件地址。有关别名的更多信息，请参阅 sendemail.aliasesFile。

--translate-aliases

不执行常规操作，而是从标准输入读取并将每行解释为一个电子邮件别名。根据配置的别名文件对其进行转换。将转换后的每个姓名和电子邮件地址输出到标准输出，每行一个。有关别名的更多信息，请参阅 sendemail.aliasFile。

配置

本节中以下所有内容均从 git-config[1] 文档中选择性地包含。内容与彼处相同：

sendemail.identity

配置身份。指定时，会导致 sendemail.<身份> 子部分中的值优先于 sendemail 部分中的值。默认身份是 sendemail.identity 的值。

sendemail.smtpEncryption

说明请参见 git-send-email[1]。注意，此设置不受 identity 机制的影响。

sendemail.smtpSSLCertPath

CA 证书的路径（目录或单个文件）。将其设置为空字符串可禁用证书验证。

sendemail.<身份>.*

下文中 sendemail.* 参数的特定身份版本，当通过命令行或 sendemail.identity 选择此身份时，这些参数优先于通用参数。

sendemail.multiEdit

如果为 true（默认值），将启动单个编辑器实例来编辑您必须编辑的文件（使用 --annotate 时的补丁，以及使用 --compose 时的摘要）。如果为 false，文件将一个接一个地编辑，每次启动一个新的编辑器。

sendemail.confirm

设置发送前是否确认的默认值。必须是 always、never、cc、compose 或 auto 之一。有关这些值的含义，请参阅 git-send-email[1] 文档中的 --confirm。

sendemail.mailmap

如果为 true，则使 git-send-email[1] 默认使用 --mailmap，否则默认使用 --no-mailmap。默认为 false。

sendemail.mailmap.file

特定于 git-send-email[1] 的补充 mailmap 文件的位置。系统会先加载默认 mailmap 和 mailmap.file。因此，此文件中的条目优先于默认 mailmap 位置中的条目。参见 gitmailmap[5]。

sendemail.mailmap.blob

类似于 sendemail.mailmap.file，但将其值视为对仓库中 blob 的引用。sendemail.mailmap.file 中的条目优先于此处的条目。参见 gitmailmap[5]。

sendemail.aliasesFile

为了避免输入长邮件地址，请将此项指向一个或多个邮件别名文件。您还必须提供 sendemail.aliasFileType。

sendemail.aliasFileType

sendemail.aliasesFile 中指定的文件格式。必须是 mutt、mailrc、pine、elm、gnus 或 sendmail 之一。

每种格式的别名文件样式可在同名邮件程序的文档中找到。与标准格式的区别和限制如下：

sendmail

  • 不支持带引号的别名和带引号的地址：包含 " 符号的行将被忽略。

  • 不支持重定向到文件 (/path/name) 或管道 (|command)。

  • 不支持文件包含 (:include: /path/name)。

  • 对于任何明确不支持的结构，以及解析器无法识别的其他任何行，都会在标准错误输出中打印警告。

sendemail.annotate
sendemail.bcc
sendemail.cc
sendemail.ccCmd
sendemail.chainReplyTo
sendemail.envelopeSender
sendemail.from
sendemail.headerCmd
sendemail.signedOffByCc
sendemail.smtpPass
sendemail.suppressCc
sendemail.suppressFrom
sendemail.to
sendemail.toCmd
sendemail.smtpDomain
sendemail.smtpServer
sendemail.smtpServerPort
sendemail.smtpServerOption
sendemail.smtpUser
sendemail.imapSentFolder
sendemail.useImapOnly
sendemail.thread
sendemail.transferEncoding
sendemail.validate
sendemail.xmailer

这些配置变量都为 git-send-email[1] 命令行选项提供默认值。详情请参见其文档。

sendemail.outlookidfix

如果为 true，则使 git-send-email[1] 默认使用 --outlook-id-fix，如果为 false 则默认使用 --no-outlook-id-fix。如果未指定，其行为与未指定 --outlook-id-fix 时相同。

sendemail.signedOffCc (已弃用)

sendemail.signedOffByCc 的已弃用别名。

sendemail.smtpBatchSize

每个连接发送的消息数量，之后将重新登录。如果值为 0 或未定义，则在一个连接中发送所有消息。另请参阅 git-send-email[1] 的 --batch-size 选项。

sendemail.smtpReloginDelay

重新连接 SMTP 服务器之前等待的秒数。另请参阅 git-send-email[1] 的 --relogin-delay 选项。

sendemail.forbidSendmailVariables

为了避免常见的配置错误，如果存在任何 sendmail 的配置选项，git-send-email[1] 将中止并发出警告。设置此变量可绕过此检查。

SMTP 服务器示例

使用 Gmail 作为 SMTP 服务器

要使用 git send-email 通过 Gmail SMTP 服务器发送补丁，请编辑 ~/.gitconfig 以指定您的帐户设置：

[sendemail]
	smtpEncryption = ssl
	smtpServer = smtp.gmail.com
	smtpUser = yourname@gmail.com
	smtpServerPort = 465

Gmail 不允许在 git send-email 中使用普通密码。如果您的 Gmail 帐户设置了多重身份验证，您可以生成一个应用专用密码供 git send-email 使用。访问 https://security.google.com/settings/security/apppasswords 来创建它。

或者，您可以使用 OAuth2.0 身份验证与 Gmail 配合使用，而不使用应用专用密码。OAuth2.0 比应用专用密码更安全，且无论您是否设置了多重身份验证都能工作。OAUTHBEARER 和 XOAUTH2 是此类身份验证常用的机制。Gmail 两者都支持。例如，如果您想使用 OAUTHBEARER，请编辑您的 ~/.gitconfig 文件并将 smtpAuth = OAUTHBEARER 添加到您的帐户设置中。

[sendemail]
	smtpEncryption = ssl
	smtpServer = smtp.gmail.com
	smtpUser = yourname@gmail.com
	smtpServerPort = 465
	smtpAuth = OAUTHBEARER

另一个选择是使用 Google 开发的名为 sendgmail 的工具，通过 git send-email 发送邮件。

使用 Microsoft Outlook 作为 SMTP 服务器

与 Gmail 不同，Microsoft Outlook 不再支持应用专用密码。因此，必须对 Outlook 使用 OAuth2.0 身份验证。此外，它仅支持 XOAUTH2 身份验证机制。

编辑 ~/.gitconfig 以指定 Outlook 的帐户设置，并将其 SMTP 服务器与 git send-email 配合使用：

[sendemail]
	smtpEncryption = tls
	smtpServer = smtp.office365.com
	smtpUser = yourname@outlook.com
	smtpServerPort = 587
	smtpAuth = XOAUTH2

发送补丁

一旦您的提交准备好发送到邮件列表，请运行以下命令：

$ git format-patch --cover-letter -M origin/master -o outgoing/
$ edit outgoing/0000-*
$ git send-email outgoing/*

第一次运行时，系统会提示您输入凭据。根据情况输入应用专用密码或普通密码。

如果您配置了凭据助手（参见 git-credential[1]），密码将保存在凭据库中，这样您下次就不用再输入了。

如果您使用 OAuth2.0 身份验证，在提示时需要使用访问令牌代替密码。在线可以找到各种 OAuth2.0 令牌生成器。社区维护的凭据助手也可用：

您还可以参阅 gitcredentials[7] 了解更多基于 OAuth 的身份验证助手。

Proton Mail 不提供发送邮件的 SMTP 服务器。如果您是 Proton Mail 的付费客户，可以使用官方提供的 Proton Mail Bridge 来创建本地 SMTP 服务器以发送邮件。对于免费和付费用户，可以使用像 git-protonmail 这样的社区维护项目。

注意：需要安装随 Perl 发行版提供的以下核心 Perl 模块：

MIME::Base64、MIME::QuotedPrint、Net::Domain 和 Net::SMTP。

还需要以下额外的 Perl 模块：

Authen::SASL 和 Mail::Address。

利用 git send-email 的 sendmailCmd 选项

除了通过 SMTP 服务器发送电子邮件外，git send-email 还可以通过任何支持类似 sendmail 命令的应用程序发送电子邮件。您可以阅读上文有关 --sendmail-cmd=<命令> 的文档以获取更多信息。如果您想使用另一个应用程序作为 git send-email 的 SMTP 客户端，或者如果您的电子邮件提供商使用专有 API 而非 SMTP 发送邮件，此功能将非常有用。

作为一个例子，让我们看看如何配置 msmtp，这是一种在许多 Linux 发行版中常见的流行 SMTP 客户端。编辑 ~/.gitconfig 以指示 git-send-email 使用它发送电子邮件。

[sendemail]
	sendmailCmd = /usr/bin/msmtp # Change this to the path where msmtp is installed

一些此类社区维护助手的链接包括：

  • msmtp（功能丰富的流行 SMTP 客户端，适用于 Linux 和 macOS）

  • git-protonmail（可以使用 ProtonMail API 发送电子邮件的跨平台客户端）

  • git-msgraph（可以使用 Microsoft Graph API 发送电子邮件的跨平台客户端）

另请参阅

git-format-patch[1], git-imap-send[1], mbox(5)

GIT

Git[1] 套件的一部分