设置和配置
获取和创建项目
基本快照
分支与合并
共享和更新项目
检查和比较
打补丁
调试
电子邮件
外部系统
服务器管理
指南
管理
底层命令
- 2.50.1 无更改
-
2.50.0
2025-06-16
- 2.47.1 → 2.49.1 无更改
-
2.47.0
2024-10-06
- 2.45.1 → 2.46.4 无变化
-
2.45.0
2024-04-29
- 2.44.1 → 2.44.4 无更改
-
2.44.0
2024-02-23
- 2.43.2 → 2.43.7 无变更
-
2.43.1
2024-02-09
-
2.43.0
2023-11-20
- 2.41.1 → 2.42.4 无更改
-
2.41.0
2023-06-01
- 2.39.1 → 2.40.4 无更改
-
2.39.0
2022-12-12
- 2.38.1 → 2.38.5 无更改
-
2.38.0
2022-10-02
- 2.35.1 → 2.37.7 无更改
-
2.35.0
2022-01-24
- 2.33.1 → 2.34.8 无变化
-
2.33.0
2021-08-16
- 2.30.2 → 2.32.7 无更改
-
2.30.1
2021-02-08
-
2.30.0
2020-12-27
- 2.24.1 → 2.29.3 无更改
-
2.24.0
2019-11-04
- 2.23.1 → 2.23.4 无更改
-
2.23.0
2019-08-16
- 2.22.2 → 2.22.5 无更改
-
2.22.1
2019-08-11
- 2.21.1 → 2.22.0 无更改
-
2.21.0
2019-02-24
- 2.20.1 → 2.20.5 无更改
-
2.20.0
2018-12-09
- 2.19.1 → 2.19.6 无更改
-
2.19.0
2018-09-10
- 2.18.1 → 2.18.5 无更改
-
2.18.0
2018-06-21
- 2.17.1 → 2.17.6 无更改
-
2.17.0
2018-04-02
-
2.16.6
2019-12-06
- 2.15.4 无更改
-
2.14.6
2019-12-06
- 2.13.7 无更改
-
2.12.5
2017-09-22
- 2.10.5 → 2.11.4 无更改
-
2.9.5
2017-07-30
- 2.8.6 无更改
-
2.7.6
2017-07-30
-
2.6.7
2017-05-05
-
2.5.6
2017-05-05
-
2.4.12
2017-05-05
-
2.3.10
2015-09-28
- 2.2.3 无变更
-
2.1.4
2014-12-17
-
2.0.5
2014-12-17
概要
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 的界面,以提供必要的信息。
补丁文件接受两种格式
-
mbox 格式文件
这是 git-format-patch[1] 生成的格式。大多数头部和 MIME 格式会被忽略。
-
Greg Kroah-Hartman 的 send_lots_of_email.pl 脚本使用的原始格式
这种格式要求文件的第一行包含 "Cc:" 值,第二行包含邮件的 "Subject:"。
选项
撰写
- --annotate
-
审查和编辑您即将发送的每个补丁。默认值为
sendemail.annotate
的值。有关sendemail.multiEdit
,请参阅 CONFIGURATION(配置)部分。 - --bcc=<address>,…
-
为每封电子邮件指定一个 "Bcc:" 值。默认值为
sendemail.bcc
的值。此选项可以多次指定。
- --cc=<address>,…
-
为每封电子邮件指定一个起始 "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
,请参阅 CONFIGURATION(配置)部分。 - --from=<address>
-
指定电子邮件的发送者。如果在命令行中未指定,则使用
sendemail.from
配置选项的值。如果命令行选项和sendemail.from
都未设置,则会提示用户输入该值。提示的默认值将是 GIT_AUTHOR_IDENT 的值,如果未设置,则为 GIT_COMMITTER_IDENT 的值,这些值由 "git var -l" 返回。 - --reply-to=<address>
-
指定收件人回复的地址。如果消息的回复应发送到与 --from 参数指定的地址不同的地址,请使用此选项。
- --in-reply-to=<identifier>
-
使第一封邮件(或所有带
--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,则将提示输入此项。
- --[no-]outlook-id-fix
-
Microsoft Outlook SMTP 服务器会丢弃通过电子邮件发送的 Message-ID 并分配一个新的随机 Message-ID,从而破坏会话。
使用
--outlook-id-fix
时,git send-email 会使用针对 Outlook 服务器的特定机制来获取服务器分配的 Message-ID,以修复会话。仅当您知道服务器以与 Outlook 服务器相同的方式报告重写的 Message-ID 时才使用此选项。如果未指定此选项,在与 smtp.office365.com 或 smtp-mail.outlook.com 通信时,默认会进行修复。即使在与这两个服务器通信时,也要使用
--no-outlook-id-fix
来禁用此功能。 - --subject=<string>
-
指定电子邮件会话的初始主题。仅当 --compose 也设置时才需要。如果未设置 --compose,则将提示输入此项。
- --to=<address>,…
-
指定生成的电子邮件的主要收件人。通常,这将是相关项目的上游维护者。默认值为
sendemail.to
配置的值;如果未指定,且未指定 --to-cmd,则将提示输入。此选项可以多次指定。
- --8bit-encoding=<encoding>
-
当遇到未声明其编码的非 ASCII 消息或主题时,添加头部/引用以指示其编码为 <encoding>。默认值为 sendemail.assume8bitEncoding 的值;如果未指定,则在遇到任何非 ASCII 文件时将提示输入。
请注意,未进行任何尝试来验证编码。
- --compose-encoding=<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=<address>
-
指定用于发送电子邮件的信封发送者。如果您的默认地址不是订阅列表的地址,这将很有用。为了使用 From 地址,请将值设置为 "auto"。如果您使用 sendmail 二进制文件,您必须具有 -f 参数的适当权限。默认值为
sendemail.envelopeSender
配置变量的值;如果未指定,则选择信封发送者的操作将留给您的 MTA。 - --sendmail-cmd=<command>
-
指定用于发送电子邮件的命令。该命令应类似于 sendmail;特别是,它必须支持
-i
选项。如有必要,该命令将在 shell 中执行。默认值为sendemail.sendmailCmd
的值。如果未指定,并且如果也未指定 --smtp-server,则 git-send-email 将在/usr/sbin
、/usr/lib
和 $PATH 中搜索sendmail
。 - --smtp-encryption=<encryption>
-
指定 SMTP 连接加密开始的方式。有效值为 ssl 和 tls。任何其他值将恢复为普通(未加密)SMTP,默认端口为 25。尽管名称不同,但这两个值都将使用相同的新版本 TLS,但由于历史原因而保留这些名称。ssl 指的是“隐式”加密(有时称为 SMTPS),默认使用端口 465。tls 指的是“显式”加密(通常称为 STARTTLS),默认使用端口 25。SMTP 服务器可能会使用其他非默认端口。tls 和未加密的常用替代端口是 587。您需要检查您的提供商文档或服务器配置以确保您自己的情况。默认值为
sendemail.smtpEncryption
的值。 - --smtp-domain=<FQDN>
-
指定在 HELO/EHLO 命令中发送给 SMTP 服务器的完全限定域名 (FQDN)。有些服务器要求 FQDN 与您的 IP 地址匹配。如果未设置,git send-email 会尝试自动确定您的 FQDN。默认值为
sendemail.smtpDomain
的值。 - --smtp-auth=<mechanisms>
-
允许的 SMTP-AUTH 机制的空格分隔列表。此设置强制仅使用列出的机制。例如
$ git send-email --smtp-auth="PLAIN LOGIN GSSAPI" ...
如果至少一个指定的机制与 SMTP 服务器宣称的机制匹配,并且它受到所使用的 SASL 库的支持,则该机制将用于身份验证。如果既未指定 sendemail.smtpAuth 也未指定
--smtp-auth
,则可以使用 SASL 库支持的所有机制。可以指定特殊值 none 以完全禁用身份验证,而与--smtp-user
无关。 - --smtp-pass[=<password>]
-
SMTP-AUTH 的密码。参数是可选的:如果未指定参数,则使用空字符串作为密码。默认值为
sendemail.smtpPass
的值,但是--smtp-pass
始终覆盖此值。此外,密码无需在配置文件或命令行中指定。如果已指定用户名(通过
--smtp-user
或sendemail.smtpUser
),但未指定密码(通过--smtp-pass
或sendemail.smtpPass
),则使用 git-credential 获取密码。 - --no-smtp-auth
-
禁用 SMTP 身份验证。是
--smtp-auth=none
的简写形式。 - --smtp-server=<host>
-
如果设置,指定要使用的传出 SMTP 服务器(例如
smtp.example.com
或原始 IP 地址)。如果未指定,并且如果--sendmail-cmd
也未指定,则默认是在/usr/sbin
、/usr/lib
和 $PATH 中搜索sendmail
(如果此类程序可用),否则回退到localhost
。为了向后兼容,此选项还可以指定类似 sendmail 程序的完整路径名;该程序必须支持
-i
选项。此方法不支持传递参数或使用普通命令名称。对于这些用例,请考虑改用--sendmail-cmd
。 - --smtp-server-port=<port>
-
指定与默认端口不同的端口(SMTP 服务器通常侦听 smtp 端口 25,但也可能侦听提交端口 587,或常见的 SSL smtp 端口 465);符号端口名称(例如 "submission" 而不是 587)也接受。端口也可以通过
sendemail.smtpServerPort
配置变量设置。 - --smtp-server-option=<option>
-
如果设置,指定要使用的传出 SMTP 服务器选项。默认值可以通过
sendemail.smtpServerOption
配置选项指定。--smtp-server-option 选项必须为每个要传递给服务器的选项重复。同样,配置文件中必须为每个选项使用不同的行。
- --smtp-ssl
-
--smtp-encryption ssl 的旧版别名。
- --smtp-ssl-cert-path
-
SMTP SSL/TLS 证书验证可信 CA 证书存储的路径(可以是已由 c_rehash 处理的目录,也可以是包含一个或多个 PEM 格式证书的单个文件:有关详细信息,请参阅 verify(1) -CAfile 和 -CApath)。将其设置为空字符串以禁用证书验证。默认为
sendemail.smtpSSLCertPath
配置变量的值(如果已设置),否则为支持 SSL 库的编译默认值(这在大多数平台上应是最佳选择)。 - --smtp-user=<user>
-
SMTP-AUTH 的用户名。默认值为
sendemail.smtpUser
的值;如果未指定用户名(通过--smtp-user
或sendemail.smtpUser
),则不尝试身份验证。 - --smtp-debug=(0|1)
-
启用 (1) 或禁用 (0) 调试输出。如果启用,将打印 SMTP 命令和回复。有助于调试 TLS 连接和身份验证问题。
- --batch-size=<num>
-
某些电子邮件服务器(例如 smtp.163.com)限制每个会话(连接)发送的电子邮件数量,这会导致发送大量消息时失败。使用此选项,send-email 将在发送 $
条消息后断开连接,等待几秒钟(参见 --relogin-delay)然后重新连接,以绕过此类限制。您可能希望使用某种凭据助手来避免每次发生这种情况时都必须重新输入密码。默认值为 sendemail.smtpBatchSize
配置变量的值。 - --relogin-delay=<int>
-
在重新连接到 SMTP 服务器之前等待 $
秒。与 --batch-size 选项一起使用。默认值为 sendemail.smtpReloginDelay
配置变量的值。
自动化
- --no-to
- --no-cc
- --no-bcc
-
清除之前通过配置设置的任何 "To:"、"Cc:"、"Bcc:" 地址列表。
- --no-identity
-
清除之前通过配置读取的
sendemail.identity
值(如果有)。 - --to-cmd=<command>
-
指定一个命令,该命令对每个补丁文件执行一次,以生成补丁文件特定的 "To:" 条目。此命令的输出必须是每行一个电子邮件地址。默认值为 sendemail.toCmd 配置的值。
- --cc-cmd=<command>
-
指定一个命令,该命令对每个补丁文件执行一次,以生成补丁文件特定的 "Cc:" 条目。此命令的输出必须是每行一个电子邮件地址。默认值为
sendemail.ccCmd
配置的值。 - --header-cmd=<command>
-
指定一个命令,该命令对每个传出消息执行一次,并输出要插入其中的 RFC 2822 样式头部行。当
sendemail.headerCmd
配置变量设置时,其值始终被使用。当在命令行提供 --header-cmd 时,其值优先于sendemail.headerCmd
配置变量。 - --no-header-cmd
-
禁用任何正在使用的头部命令。
- --[no-]chain-reply-to
-
如果设置此项,每封电子邮件都将作为对前一封已发送电子邮件的回复发送。如果使用 "--no-chain-reply-to" 禁用此项,则第一封邮件之后的所有电子邮件都将作为对第一封已发送电子邮件的回复发送。使用此选项时,建议提供的第一个文件是整个补丁系列的概述。默认情况下禁用,但可以使用
sendemail.chainReplyTo
配置变量启用它。 - --identity=<identity>
-
配置身份。如果给出此项,则 sendemail.<identity> 子节中的值将优先于 sendemail 节中的值。默认身份是
sendemail.identity
的值。 - --[no-]signed-off-by-cc
-
如果设置此项,将把在
Signed-off-by
尾部或 Cc: 行中找到的电子邮件添加到抄送列表。默认值为sendemail.signedOffByCc
配置的值;如果未指定,则默认为 --signed-off-by-cc。 - --[no-]cc-cover
-
如果设置此项,则将补丁系列(通常是封面信)中第一个补丁的 Cc: 头部中找到的电子邮件添加到每个电子邮件集的抄送列表。默认值为 sendemail.ccCover 配置的值;如果未指定,则默认为 --no-cc-cover。
- --[no-]to-cover
-
如果设置此项,则将补丁系列(通常是封面信)中第一个补丁的 To: 头部中找到的电子邮件添加到每个电子邮件集的收件人列表。默认值为 sendemail.toCover 配置的值;如果未指定,则默认为 --no-to-cover。
- --suppress-cc=<category>
-
指定要抑制自动抄送的收件人附加类别
-
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。 -
- --[no-]suppress-from
-
如果设置此项,则不要将 From: 地址添加到 cc: 列表。默认值为
sendemail.suppressFrom
配置的值;如果未指定,则默认为 --no-suppress-from。 - --[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 中产生预期的结果。
- --[no-]mailmap
-
使用 mailmap 文件(参见 gitmailmap[5])将所有地址映射到其规范的真实姓名和电子邮件地址。可以使用
sendemail.mailmap.file
或sendemail.mailmap.blob
配置值提供特定于 git-send-email 的额外 mailmap 数据。默认为sendemail.mailmap
。
管理
- --confirm=<mode>
-
发送前确认
-
always(总是)将在发送前始终确认
-
never(从不)将从不在发送前确认
-
cc(抄送)将在 send-email 自动将补丁中的地址添加到抄送列表时在发送前确认
-
compose(撰写)在使用 --compose 时将在发送第一条消息前确认。
-
auto(自动)等同于 cc + compose
默认值为
sendemail.confirm
配置的值;如果未指定,则默认为 auto,除非已指定任何抑制选项,在这种情况下默认为 compose。 -
- --dry-run
-
执行所有操作,但实际发送电子邮件除外。
- --[no-]format-patch
-
当一个参数可以理解为引用或文件名时,选择将其理解为 format-patch 参数(
--format-patch
)或文件名(--no-format-patch
)。默认情况下,当出现此类冲突时,git send-email 将失败。 - --quiet
-
使 git-send-email 减少冗余输出。每个电子邮件只应输出一行。
- --[no-]validate
-
对补丁执行健全性检查。目前,验证意味着以下内容
-
如果存在 sendemail-validate 钩子(参见 githooks[5]),则调用它。
-
警告包含超过 998 个字符的行长的补丁,除非使用了合适的传输编码(auto、base64 或 quoted-printable);这是由于 https://www.ietf.org/rfc/rfc5322.txt 中描述的 SMTP 限制。
默认值为
sendemail.validate
的值;如果未设置,则默认为--validate
。 -
- --force
-
即使安全检查会阻止,也发送电子邮件。
配置
本节中以下所有内容均从 git-config[1] 文档中选择性地包含。内容与彼处相同:
- sendemail.identity
-
配置身份。如果给出此项,则 sendemail.<identity> 子节中的值将优先于 sendemail 节中的值。默认身份是
sendemail.identity
的值。 - sendemail.smtpEncryption
-
有关描述,请参见 git-send-email[1]。请注意,此设置不受 identity 机制的影响。
- sendemail.smtpSSLCertPath
-
ca-certificates 的路径(可以是目录或单个文件)。将其设置为空字符串以禁用证书验证。
- sendemail.<identity>.*
-
下面找到的 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 之一。
每种格式的别名文件是什么样子,可以在同名电子邮件程序的文档中找到。与标准格式的区别和限制如下所述
- 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.thread
- sendemail.transferEncoding
- sendemail.validate
- sendemail.xmailer
-
所有这些配置变量都为 git-send-email[1] 命令行选项提供了默认值。有关详细信息,请参见其文档。
- 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 = tls smtpServer = smtp.gmail.com smtpUser = yourname@gmail.com smtpServerPort = 587
如果您的 Gmail 账户设置了多重身份验证,您可以生成一个应用专用密码供 git send-email 使用。访问 https://security.google.com/settings/security/apppasswords 创建它。
您还可以将 OAuth2.0 身份验证与 Gmail 一起使用。OAUTHBEARER
和 XOAUTH2
是此类身份验证常用的方法。Gmail 支持这两种方法。例如,如果您想使用 OAUTHBEARER
,请编辑您的 ~/.gitconfig
文件并将 smtpAuth
=
OAUTHBEARER
添加到您的账户设置中。
[sendemail] smtpEncryption = tls smtpServer = smtp.gmail.com smtpUser = yourname@gmail.com smtpServerPort = 587 smtpAuth = OAUTHBEARER
使用 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 令牌生成器可在网上获取。针对 Gmail 和 Outlook 的社区维护的凭据助手也可用:
-
git-credential-gmail (跨平台,专门用于验证 Gmail 账户的助手)
-
git-credential-outlook (跨平台,专门用于验证 Microsoft Outlook 账户的助手)
您还可以查看 gitcredentials[7] 以获取更多基于 OAuth 的身份验证助手。
注意:您的 Perl 发行版可能附带安装以下核心 Perl 模块是必需的:MIME::Base64、MIME::QuotedPrint、Net::Domain 和 Net::SMTP。还需要以下附加 Perl 模块:Authen::SASL 和 Mail::Address。
另请参阅
git-format-patch[1], git-imap-send[1], mbox(5)