GitHub 配置通知

选择 GitHub 上您想要接收其通知的活动类型以及您希望如何发送这些更新。

通知传递选项

通知传递有三个基本选项：

GitHub 上的通知收件箱
GitHub for mobile 上的通知收件箱，它与 GitHub 上的收件箱同步
使用经验证电子邮件地址的电子邮件客户端，也可以与 GitHub 及 GitHub for mobile 上的通知收件箱同步

要在 GitHub 和 GitHub for mobile 上使用通知收件箱，必须在通知设置中启用 Web 和移动通知。有关更多信息，请参见 "Choosing your notification settings."

提示：如果您同时接收 Web 和电子邮件通知，您可以自动同步通知的已读或未读状态，以便在您阅读相应的电子邮件通知后，Web 通知自动标记为已读。要启用此同步，您的电子邮件客户端必须能够查看来自 'notifications@github.com' 的图像。

通知收件箱的优点

GitHub 和 GitHub for mobile 上的通知收件箱包含专为您的 GitHub 通知流程设计的分类选项，包括：

一次对多种通知进行分类。
将已完成的通知标记为完成并从收件箱中删除它们。要查看标记为完成的所有通知，请使用 is:done 查询。
保存通知以供以后查看。保存的通知将在收件箱中标记并无限期保留。要查看所有已保存的通知，请使用 is:saved 查询。
取消订阅并从收件箱中删除通知。
从通知收件箱预览 GitHub 上产生通知的议题、拉取请求或团队讨论。
使用 reasons 标签查看收件箱中收到通知的最新原因之一。
创建自定义过滤器，以便按需要关注不同的通知。
按仓库或日期对收件箱中的通知进行分组，以快速概览通知，减少上下文切换

此外，移动版GitHub上的通知收件箱允许您在暗模式下对通知进行分类，并接收直接提及的推送通知。有关更多信息，请参阅“ 在GitHub上为移动设备启用推送通知 ”或“在GitHub上移动设备”。

对通知使用电子邮件客户端的优点

使用电子邮件客户端的一个好处是，可以根据电子邮件客户端的存储容量无限期地保留所有通知。除非您将收件箱通知标记为已保存，否则它们只会保留5个月。保存的通知将无限期保存。有关收件箱的保留政策的更多信息，请参阅“ 关于通知”。

通过向电子邮件客户端发送通知，您还可以根据电子邮件客户端的设置来自定义收件箱，其中可以包含自定义标签或颜色编码的标签。

电子邮件通知还使您可以灵活地接收收到的通知，并可以选择其他电子邮件地址进行更新。例如，您可以将存储库的某些通知发送到经过验证的个人电子邮件地址。有关您的电子邮件自定义选项的更多信息，请参阅“ 自定义电子邮件通知”。

关于参与和查看通知

当您查看存储库时，您正在订阅该存储库中活动的更新。同样，当您观看特定团队的讨论时，您正在订阅该团队页面上的所有对话更新。要查看您正在查看的存储库，请参阅https://github.com/watching。有关更多信息，请参阅“ 在GitHub上管理订阅和通知 ”。

每当您在对话中发表评论时，或者当有人@提及您的用户名时，您都在参与对话。默认情况下，参与对话会自动为您订阅对话。您可以通过单击问题或拉动请求上的“ 取消订阅”或通过通知收件箱中的“ 取消订阅”选项来取消订阅您手动参与的对话。

对于您关注或参与的对话，您可以选择是通过电子邮件还是 GitHub 和 GitHub for mobile 上的收件箱接收通知。

参与和观看通知选项

例如：

如果您不希望将通知发送到您的电子邮件地址，请取消选中 email（电子邮件）以便参与和查看通知。
如果您希望在参与对话时通过电子邮件接收通知，则可以选中“Participating（参与）”下的 email（电子邮件）。

如果您未对 Web 和移动启用关注或参与通知，则您的通知收件箱不会收到任何更新。

自定义电子邮件通知

在启用电子邮件通知后，GitHub 将以多部分电子邮件向您发送通知，其中包含内容的 HTML 和明文副本。电子邮件通知内容包含出现在 GitHub 上的原始内容中的任何 Markdown、@提及、表情符号、哈希链接等。如果您只想查看电子邮件中的文本，可以配置电子邮件客户端只显示明文副本。

提示：如果您同时接收 Web 和电子邮件通知，您可以自动同步通知的已读或未读状态，以便在您阅读相应的电子邮件通知后，Web 通知自动标记为已读。要启用此同步，您的电子邮件客户端必须能够查看来自 'notifications@github.com'的图像。

如果您使用 Gmail，可以单击通知电子邮件旁边的按钮访问生成该通知的原始议题或拉取请求。

Gmail 中的按钮

选择一个默认电子邮件地址，您要在其中向您正在参与或正在观看的对话发送更新。您还可以使用默认电子邮件地址指定要在GitHub上接收更新的活动。例如，选择是否要通过以下方式更新默认电子邮件：

对问题和拉取请求的评论。
拉取请求审查.
拉取请求推送。
您自己的更新，例如当您打开、评论或关闭议题或拉取请求时。

根据拥有存储库的组织，您还可以将通知发送到特定存储库的不同电子邮件地址。例如，您可以将特定公共存储库的通知发送到经过验证的个人电子邮件地址。您的组织可能要求验证特定域的电子邮件地址。更多信息请参阅“选择接收组织的电子邮件通知的位置”。

只有在通知设置中选择了接收电子邮件通知时，才会收到通知电子邮件。

如果您所在的组织将电子邮件通知限于已批准的电子邮件域，则您需要验证该域的电子邮件地址才可接收有关组织中活动的电子邮件通知。更多信息请参阅“将电子邮件通知限于经批准的域”。

过滤电子邮件通知

GitHub 发送的每封电子邮件通知都包含标头信息。每封电子邮件的标头信息都是一致的，因此可用于电子邮件客户端中过滤或转发所有 GitHub 通知，或特定类型的 GitHub 通知。

如果您认为收到的通知不属于您，请检查X-GitHub-Recipient和X-GitHub-Recipient-Address标头。这些标题显示了预期的收件人。根据您的电子邮件设置，您可能会收到针对其他用户的通知。

来自 GitHub 的电子邮件通知包含以下标头信息：

标头	信息
`From` 地址	此地址始终是 '`notifications@github.com`'。
`To` 字段	此字段直接连接到线程。如果您回复电子邮件，将会为对话添加新评论。
`Cc` 地址	如果您订阅了对话，GitHub 将会 `Cc` 给您。第二个 `Cc` 电子邮件地址与通知原因匹配。这些通知原因的后缀是 `@noreply.github.com`。可能的通知原因包括：`assign`：您被分配到议题或拉取请求。`author`：您创建了议题或拉取请求。`comment`：您评论了议题或拉取请求。`manual`：您手动订阅的议题或拉取请求有更新。`mention`：您提及了议题或拉取请求。`push`：有人提交了您订阅的拉取请求。`review_requested`：您或您所在的团队已请求审查拉取请求。`security_alert`：GitHub 检测到您要接收其漏洞警报的仓库中存在漏洞。`state_change`：您订阅的议题或拉取请求已关闭或打开。`subscribed`：您查看的仓库有更新。`team_mention`：您所属的团队在议题或拉取请求中被提及。`your_activity`：您打开、评论或关闭了议题或拉取请求。
`mailing list` 字段	此字段识别仓库名称及其所有者。此地址的格式始终是 `<仓库名称>.<仓库所有者>.github.com`。
`X-GitHub-Severity` 字段	影响一个或多个存储库的GitHub Dependabot警报的电子邮件通知包括 `X-GitHub-Severity` 标头字段。您可以使用`X-GitHub-Severity` 标头字段的值来过滤GitHub Dependabot警报的电子邮件通知。可能的严重程度等级包括：低``中``高``关键更多信息请参阅“关于易受攻击的依赖项的警报”。