配置通知

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

本文档

通知传递选项

您可以在以下位置接收有关 GitHub 活动的通知。

  • GitHub 网页界面的通知收件箱
  • GitHub Mobile 的通知收件箱，与网页界面的收件箱同步
  • 使用已验证电子邮件地址的电子邮件客户端，也可以与网页界面的通知收件箱和 GitHub Mobile 同步

要使用 GitHub 和 GitHub Mobile 上的通知收件箱，您必须在通知设置中启用网页和移动通知。有关更多信息，请参阅“选择您的通知设置”。

提示：如果您同时收到网页和电子邮件通知，您可以自动同步通知的已读或未读状态，以便在您阅读相应的电子邮件通知后，网页通知会自动标记为已读。要启用此同步，您的电子邮件客户端必须能够查看来自 [email protected] 的图片。

通知收件箱的优势

通知收件箱包含专门为您的 GitHub 通知流程设计的分类选项，包括以下选项：

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

此外，您还可以使用 GitHub Mobile 在移动设备上接收和分类通知。有关更多信息，请参阅“使用 GitHub Mobile 管理您的通知设置”或“GitHub Mobile”。

使用电子邮件客户端接收通知的优势

使用电子邮件客户端的一个好处是，所有通知都可以无限期保留，具体取决于您的电子邮件客户端的存储容量。您的收件箱通知在 GitHub 上只保留 5 个月，除非您将其标记为已保存。已保存的通知将无限期保留。有关收件箱保留策略的更多信息，请参阅“关于通知”。

将通知发送到您的电子邮件客户端还可以让您根据电子邮件客户端的设置自定义收件箱，包括自定义或颜色编码的标签。

电子邮件通知还允许您灵活地选择接收的通知类型，并允许您为更新选择不同的电子邮件地址。例如，您可以将某个仓库的某些通知发送到经过验证的个人电子邮件地址。有关电子邮件自定义选项的更多信息，请参阅“自定义您的电子邮件通知”。

关于参与和关注通知

当您关注一个仓库时，您就订阅了该仓库活动更新。

要查看您正在关注的仓库，请访问您的 关注页面。有关更多信息，请参阅“管理 GitHub 活动订阅”。

您可以在仓库页面或您的关注页面上配置仓库的通知。

关于自定义通知

您可以自定义仓库的通知。例如，您可以选择仅在仓库中发生一项或多项类型事件（问题、拉取请求、发布、安全警报或讨论）的更新时才收到通知，或者忽略仓库的所有通知。有关更多信息，请参阅下面“配置单个仓库的关注设置”。

参与对话

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

对于您正在关注或参与的对话，您可以在通知设置中选择是否要在 GitHub 或通过电子邮件接收通知。有关更多信息，请参阅“选择您的通知设置”。

例如，在您的“通知设置”页面上

  • 如果您不希望通知发送到您的电子邮件，请取消选中“参与”和“关注”通知的“电子邮件”。
  • 如果您希望在参与对话时通过电子邮件接收通知，请在“参与”下选中“电子邮件”。

如果您没有为关注或参与通知启用“通知我：在 GitHub 上”，那么您的通知收件箱将不会有任何更新。

自定义您的电子邮件通知

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

提示：如果您同时收到网页和电子邮件通知，您可以自动同步通知的已读或未读状态，以便在您阅读相应的电子邮件通知后，网页通知会自动标记为已读。要启用此同步，您的电子邮件客户端必须能够查看来自 [email protected] 的图片。

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

选择一个默认电子邮件地址，您希望将参与或关注的对话的更新发送到该地址。您还可以指定您希望使用默认电子邮件地址接收哪些 GitHub 活动的更新。例如，选择您是否希望从以下方面接收更新到您的默认电子邮件：

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

根据拥有存储库的组织，您也可以将通知发送到不同的电子邮件地址。您的组织可能要求电子邮件地址在特定域中进行验证。有关更多信息，请参阅“配置通知”。

您也可以将特定存储库的通知发送到电子邮件地址。有关更多信息，请参阅“关于推送至您的存储库的电子邮件通知”。

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

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

过滤电子邮件通知

GitHub 发送的每个电子邮件通知都包含标题信息。每封电子邮件中的标题信息都是一致的，因此您可以在电子邮件客户端中使用它来过滤或转发所有 GitHub 通知，或某些类型的 GitHub 通知。

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

来自 GitHub 的电子邮件通知包含标题信息。

标题信息
From 地址此地址始终为 '[email protected]'。
To 字段此字段直接连接到线程。如果您回复电子邮件，您将在对话中添加一条新评论。
Cc 地址如果您订阅了对话，GitHub 将会 Cc 您。第二个 Cc 电子邮件地址与通知原因相匹配。这些通知原因的后缀为 @noreply.github.com。可能的通知原因是
  • assign: 您被分配到一个问题或拉取请求。
  • author: 您创建了一个问题或拉取请求。
  • ci_activity: 您触发的 GitHub Actions 工作流程运行已完成。
  • comment: 您在问题或拉取请求中发表了评论。
  • manual: 您手动订阅的问题或拉取请求有更新。
  • mention: 您在问题或拉取请求中被提及。
  • push: 有人提交了您订阅的拉取请求。
  • review_requested: 您或您所属的团队被要求审查拉取请求。
  • security_alert: GitHub 在您接收警报的存储库中检测到漏洞。
  • state_change: 您订阅的问题或拉取请求已关闭或打开。
  • subscribed: 您正在关注的存储库有更新。
  • team_mention: 您所属的团队在问题或拉取请求中被提及。
  • your_activity: 您打开、评论或关闭了问题或拉取请求。
List-Id 字段此字段标识存储库的名称及其所有者。此地址的格式始终为 OWNER/REPOSITORY <REPOSITORY.OWNER>，例如 List-Id: grain-lang/grain <grain.grain-lang.github.com>。
X-GitHub-Severity 字段影响一个或多个存储库的 Dependabot 警报的电子邮件通知包含 X-GitHub-Severity 标头字段。您可以使用 X-GitHub-Severity 标头字段的值来过滤 Dependabot 警报的电子邮件通知。可能的严重程度级别是
  • 低
  • 中等
  • 高
  • 严重
有关更多信息，请参阅 "关于 Dependabot 警报."

选择您的通知设置

  1. 在任何页面的右上角，单击 .

    Screenshot of the right corner of the header of GitHub. An inbox icon has a blue dot, indicating that there are unread notifications.

  2. 在左侧边栏中，在存储库列表下方，使用“管理通知”下拉菜单点击**通知设置**。

    Screenshot of the "Notifications" page. A dropdown menu, titled "Manage notifications", is highlighted with an orange outline.

  3. 在通知设置页面，选择您在以下情况时如何接收通知

    • 您正在关注的存储库或您参与的对话中有更新。有关更多信息，请参阅“关于参与和关注通知”。
    • 您获得了新存储库的访问权限或加入了新团队。有关更多信息，请参阅“自动关注”。
    • 您的存储库中出现新的 Dependabot 警报。有关更多信息，请参阅“Dependabot 警报通知选项”。
    • 使用 GitHub Actions 设置的存储库中存在工作流程运行更新。有关更多信息，请参阅“GitHub Actions 通知选项”。
    • 您是所有者的组织所属的存储库中添加了新的部署密钥。有关更多信息，请参阅“组织警报通知选项”。

自动关注

默认情况下，每当您获得新存储库的访问权限时，您将自动开始关注该存储库。每当您加入新团队时，您将自动订阅更新，并在该团队被 @提及时收到通知。如果您不想自动订阅，可以在通知设置中取消选中自动关注选项。

Screenshot of the toggles for "Automatically watch repositories" and "Automatically watch teams".

如果“自动关注存储库”被禁用，那么您将不会自动关注您自己的存储库。您必须导航到您的存储库页面并选择关注选项。

有关更多信息，请参阅“配置通知”。

配置单个存储库的关注设置

您可以选择关注或取消关注单个存储库。您还可以选择仅在特定事件类型（如问题、拉取请求、发布、安全警报或讨论（如果存储库已启用））时收到通知，或完全忽略单个存储库。

  1. 在 GitHub.com 上，导航到存储库的主页。

  2. 在右上角，选择“Watch”下拉菜单，然后点击一个观看选项。

    如果您想进一步自定义通知，请点击**Custom**，然后选择您想要接收通知的特定事件，例如 Issues 或 Pull Requests，以及参与和@mentions。

    例如，如果您选择“Issues”，您将收到有关存储库中每个问题（包括您选择此选项之前存在的那些问题）的更新通知，并订阅这些更新。如果您在该存储库的 pull request 中被@提及，您也会收到该 pull request 的通知，并且您将订阅该特定 pull request 的更新，此外还会收到有关问题的通知。

选择组织的电子邮件通知发送位置

如果您属于某个组织，您可以选择您希望将组织活动通知发送到的电子邮件帐户。例如，如果您属于工作组织，您可能希望将通知发送到您的工作电子邮件地址，而不是您的个人地址。

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

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

  1. 在任何页面的右上角，单击 .

    Screenshot of the right corner of the header of GitHub. An inbox icon has a blue dot, indicating that there are unread notifications.

  2. 在左侧边栏中，在存储库列表下方，使用“管理通知”下拉菜单点击**通知设置**。

    Screenshot of the "Notifications" page. A dropdown menu, titled "Manage notifications", is highlighted with an orange outline.

  3. 在“Default notifications email”下，选择您希望将通知发送到的电子邮件地址。

按组织自定义电子邮件路由

如果您是多个组织的成员，您可以将每个组织配置为将通知发送到您的任何已验证的电子邮件地址。有关更多信息，请参阅“验证您的电子邮件地址”。

  1. 在任何页面的右上角，单击 .

    Screenshot of the right corner of the header of GitHub. An inbox icon has a blue dot, indicating that there are unread notifications.

  2. 在左侧边栏中，在存储库列表下方，使用“管理通知”下拉菜单点击**通知设置**。

    Screenshot of the "Notifications" page. A dropdown menu, titled "Manage notifications", is highlighted with an orange outline.

  3. 在“Default notifications email”下，点击**Custom routing**。

    Screenshot of the "Default notifications email" section. A button, titled "Custom routing", is highlighted with an orange outline.

  4. 点击**Add new route**。

  5. 选择**Pick organization**下拉菜单，然后点击您要自定义的组织。

  6. 选择您的一个已验证的电子邮件地址，然后点击**Save**。

    Screenshot of the "Custom Routing" page. A dropdown menu, showing a user's available email addresses, is highlighted with an orange outline.

Dependabot 警报通知选项

您可以在https://github.com/settings/notifications找到您的用户帐户的通知选项。您可以在存储库的观看设置中配置每个存储库的通知设置。

要接收有关存储库中 Dependabot 警报的通知，您需要观看这些存储库，并订阅接收“所有活动”通知或配置自定义设置以包含“安全警报”。有关更多信息，请参阅“配置通知”。您可以选择通知的传递方式，以及通知发送给您的频率。默认情况下，您将收到通知

  • 在您的收件箱中，作为网络通知。当 Dependabot 为存储库启用时，当新的清单文件提交到存储库时，以及当发现新的严重程度为严重或高的漏洞时，会发送网络通知（**在 GitHub 上**选项）。
  • 通过电子邮件，当为仓库启用 Dependabot 时，当新的清单文件提交到仓库时，以及当发现新的具有严重或高严重级别的漏洞时，会发送电子邮件（**电子邮件**选项）。
  • 在命令行上，当您推送到包含任何不安全依赖项的仓库时，警告将作为回调显示（**CLI** 选项）。
  • 在 GitHub Mobile 上，以网页通知的形式。有关更多信息，请参阅“配置通知”。

**注意：**电子邮件和网页/GitHub Mobile 通知是

  • 每个仓库，当在仓库上启用 Dependabot 时，或当新的清单文件提交到仓库时。

  • 每个组织，当发现新的漏洞时。

  • 在发现新的漏洞时发送。当漏洞更新时，GitHub 不会发送通知。

您可以自定义您收到 Dependabot 提醒的通知方式。例如，您可以使用**每周电子邮件摘要**选项接收每日或每周摘要电子邮件，其中汇总了最多 10 个仓库的提醒。

有关可用的通知传递方法以及有关优化 Dependabot 提醒通知的建议的更多信息，请参阅“配置 Dependabot 提醒的通知”。

秘密扫描通知选项

当检测到新的秘密时，GitHub 会根据用户的通知偏好，向所有有权访问仓库安全提醒的用户发送通知。这些用户包括

  • 仓库管理员
  • 安全经理
  • 具有读写访问权限的自定义角色的用户
  • 组织所有者和企业所有者，如果他们是秘密泄露的仓库的管理员

注意

意外提交秘密的提交作者将收到通知，无论他们的通知偏好如何。

您将收到电子邮件通知，如果

  • 您正在关注仓库。
  • 您已为仓库启用了“所有活动”或自定义“安全提醒”的通知。
  • 在您的通知设置中，在“订阅”下，然后在“关注”下，您已选择通过电子邮件接收通知。

有关如何配置秘密扫描提醒通知的更多信息，请参阅“配置秘密扫描提醒的通知”。

GitHub Actions 通知选项

对于已设置 GitHub Actions 且您正在关注的存储库，您可以选择接收工作流运行更新的方式。

  1. 在“通知设置”页面上的“系统”下，然后在“Actions”下，选择 **不通知** 下拉菜单。

    Screenshot of the "System" section of the notification settings. Under "Actions," a dropdown menu, titled "Don't notify", is highlighted with an orange outline.

  2. 要选择加入网页通知，请从下拉菜单中选择“在 GitHub 上”。

    要选择加入电子邮件通知，请从下拉菜单中选择“电子邮件”。

  3. 可选地，要仅接收失败工作流运行的通知，请从下拉菜单中选择“仅在工作流失败时通知”，然后单击 **保存**。

组织警报通知选项

如果您是组织所有者，当组织成员向组织内的存储库添加新的部署密钥时，您将默认收到电子邮件通知。您可以取消订阅这些通知。在通知设置页面上的“组织警报”下，取消选中 **电子邮件**。

使用 GitHub Mobile 管理您的通知设置

安装 GitHub Mobile 后，您将自动选择加入网页通知。在应用程序中，您可以为以下事件启用推送通知。

  • 直接提及
  • 分配给问题或拉取请求
  • 请求审查拉取请求
  • 请求批准部署

您还可以安排 GitHub Mobile 何时将推送通知发送到您的移动设备。

GitHub Enterprise Server 使用后台获取来支持推送通知，而无需将您的信息发送到第三方服务，因此您可能会遇到接收推送通知的延迟。

使用 GitHub for iOS 管理您的通知设置

  1. 在底部菜单中，点击 **个人资料**。
  2. 要查看您的设置，请点击 .
  3. 要更新您的通知设置，请点击 **通知**，然后使用切换按钮启用或禁用您喜欢的推送通知类型。
  4. 可选地，要安排 GitHub Mobile 何时将推送通知发送到您的移动设备，请点击 **工作时间**，使用 **自定义工作时间** 切换按钮，然后选择您希望接收推送通知的时间。

使用 GitHub for Android 管理您的通知设置

  1. 在底部菜单中，点击 **个人资料**。
  2. 要查看您的设置，请点击 .
  3. 要更新您的通知设置，请点击 **配置通知**，然后使用切换按钮启用或禁用您喜欢的推送通知类型。
  4. 可选地，要安排 GitHub Mobile 何时将推送通知发送到您的移动设备，请点击 **工作时间**，使用 **自定义工作时间** 切换按钮，然后选择您希望接收推送通知的时间。

使用 GitHub Mobile 为单个存储库配置您的关注设置

您可以选择观看或取消观看单个仓库。您还可以选择仅在特定事件类型（例如问题、拉取请求、讨论（如果仓库已启用）和新版本）发生时收到通知，或者完全忽略单个仓库。

  1. 在 GitHub 移动版上，导航到仓库的主页。
  2. 点击观看。
  3. 要选择您希望接收哪些活动的通知，请点击您喜欢的观看设置。例如，选择仅在您参与或被@提及时收到通知，或使用“自定义”选项选择您希望接收通知的特定事件。