配置通知

选择要接收通知的活动类型 GitHub 以及希望传递这些更新的方式。

在本文中

通知递送选项

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

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

若要在 GitHub 和 GitHub Mobile 上使用通知收件箱，需要同时在通知设置中为 Email 和在 GitHub 上启用通知。 有关详细信息，请参阅 “选择通知设置”。

提示

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

通知收件箱的优点

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

  • 一次处理多个通知。
  • 将已完成的通知标记为“完成”并将其从收件箱中删除。 查看所有标记为完成的通知，请使用is:done查询。
  • 保存通知以供以后查看。 已保存的通知会在收件箱中标记并无限期保留。 要查看保存的所有通知，请使用 is:saved 查询。
  • 取消订阅并从收件箱中删除通知。
  • 在通知收件箱中预览该通知来源的问题或拉取请求（位于 GitHub）。
  • 查看你从收件箱收到带有 reasons 标签的通知的最新原因之一。
  • 创建自定义筛选器，以便在需要时关注不同的通知。
  • 按存储库或日期对收件箱中的通知进行分组，以获取简要概述，并减少上下文切换。

此外，您还可以通过 GitHub Mobile 在移动设备上接收通知并进行分类处理。 有关详细信息，请参阅使用 GitHub Mobile与GitHub移动版管理通知设置。

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

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

向电子邮件客户端发送通知还允许您根据电子邮件客户端的设置（可以包括自定义或颜色编码的标签）自定义收件箱。

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

关于参与和查看通知

关注仓库，意味着订阅该仓库中的活动更新。

若要查看正在监视的存储库，请参阅监视页面。 有关详细信息，请参阅“GitHub 活动的订阅管理”。

可以在存储库页面上或在监视页面上为存储库配置通知。

注意

最多可以监视 10,000 个存储库。

关于自定义通知

您可以自定义仓库的通知。 例如，可以选择仅在存储库中发生一个或多个事件问题、拉取请求、发布、安全警报或讨论。类型的更新时收到通知，或忽略存储库的所有通知。 有关详细信息，请参阅下方的为单个存储库配置监视设置。

参与对话

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

对于正在观看或参与的对话，可以选择是要在通知设置中接收 GitHub 通知还是通过电子邮件接收通知。 有关详细信息，请参阅选择通知设置。

例如，在“通知设置”页上：

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

如果未启用“通知我：在GitHub”观看或参与通知，则通知收件箱将没有任何更新。

自定义电子邮件通知

启用电子邮件通知后， GitHub 会将通知作为包含内容的 HTML 和纯文本副本的多部分电子邮件发送给你。 电子邮件通知内容包括原始内容@mentions中显示的任何 Markdown、GitHub表情符号、哈希链接等。 如果您只想查看电子邮件中的文本，可以配置电子邮件客户端只显示明文副本。

提示

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

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

选择一个默认电子邮件地址，用于发送您参与或关注的对话的更新。 您还可以指定要使用默认电子邮件地址接收有关 GitHub 上哪些活动的更新。 例如，选择您的默认电子邮件地址是否要接收来自以下位置的更新：

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

您还可以向不同电子邮件地址发送通知，具体取决于拥有仓库的组织。 您的组织可能要求验证特定域的电子邮件地址。 有关详细信息，请参阅“管理组织通知”。

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

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

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

发送的每个电子邮件通知 GitHub 都包含可用于筛选电子邮件客户端中的通知的标头信息。 有关包含的标头的信息，请参阅 电子邮件通知标头。

回复电子邮件通知

你可以回复来自 GitHub 的电子邮件通知，你的回复将发布到相应的议题、拉取请求或讨论中。

每个电子邮件通知上的 reply-to 地址用于识别评论将来自哪个线程和帐户。 在重置密码之前，此电子邮件地址一直有效。

GitHub 不会始终包含完整的电子邮件内容，并且会尝试从通过电子邮件回复创建的评论中删除某些个人身份信息：

  • 采用标准格式的电子邮件地址（如 octocat@github.com）将转换为 ***@***.***。
  • 当电子邮件客户端使用 > 来标记这些部分时，签名和引用的回复链将被删除。
  • 虽然有时会引用电子邮件通知中的取消订阅链接，但该链接只有在登录帐户后才会起作用。
  • 生成的评论中不包括电子邮件附件。
  • 通过电子邮件回复创建的评论的最大长度为 65530 个字符。

选择通知设置

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

    GitHub 标头右角的屏幕截图。 收件箱图标带有一个蓝色点，指示有未读通知。

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

    “通知”页的屏幕截图。 标有“管理通知”的下拉菜单以橙色轮廓突出显示。

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

    • 在你关注的存储库或你参与的对话中发生了更新。 有关详细信息，请参阅 “关于参与和观看通知”。
    • 存储库中有新的 Dependabot alerts 内容。 有关详细信息，请参阅“管理安全通知”。
    • 使用 GitHub Actions 设置的仓库有工作流运行更新。 有关详细信息，请参阅 管理 GitHub Actions 通知。
    • 新的部署密钥已添加到归属于您所拥有的组织的仓库。 有关详细信息，请参阅“管理组织通知”。

配置单个仓库的关注设置

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

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

  2. 在右上角，选择“关注”下拉菜单，然后单击关注选项。

    如果要进一步自定义通知，请单击“自定义”，则除了接收关于参与和 **** 的通知外，还可以选择要接收其通知的特定事件，例如“问题”或“拉取请求”。@mentions

    例如，如果选择“问题”，你将收到关于存储库中每个问题（包括你选择此选项之前存在的问题）的更新通知并订阅这些更新。 如果你在此存储库中的拉取请求中被 @mentioned，则除了收到有关议题的通知外，你还将收到有关该特定拉取请求的通知并订阅其更新。

使用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 Mobile上，导航到存储库的主页。
  2. 点击“观看”。
  3. 要选择接收哪些活动的通知，请点击您首选的手表设置。 例如，选择仅在参与或处于 @mentioned 状态时接收通知，或使用“自定义”选项选择要接收其通知的特定事件。