Skip to main content

配置通知

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

通知递送选项

可以在以下位置的 GitHub.com 上接收活动的通知。

  • GitHub.com Web 接口中的通知收件箱
  • GitHub Mobile 上的通知收件箱,它与 GitHub.com 上的收件箱同步
  • 使用经验证电子邮件地址的电子邮件客户端,也可以与 GitHub.com 和 GitHub Mobile 上的通知收件箱同步

要在 GitHub 和 GitHub Mobile 上使用通知收件箱,必须在通知设置中启用 Web 和移动通知。 有关详细信息,请参阅“选择通知设置”。

提示: 如果同时收到网络通知和电子邮件通知,你可以自动同步通知的已读或未读状态,以便在你阅读相应的电子邮件通知后自动将网络通知标记为已读。 要启用此同步,电子邮件客户端必须能够查看来自 notifications@github.com

通知收件箱的优点

GitHub.com 和 GitHub Mobile 上的通知收件箱包含专为你的 GitHub 通知流设计的分类选项,包括:

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

此外,你可以通过 GitHub Mobile 在移动设备上接收和分类通知。 有关详细信息,请参阅“使用 GitHub Mobile 管理通知设置”或“GitHub Mobile”。

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

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

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

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

关于参与和查看通知

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

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

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

关于自定义通知

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

参与对话

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

对于你关注或参与的对话,你可在通知设置中选择是要在 GitHub 上接收通知,还是通过电子邮件接收通知。 有关详细信息,请参阅“选择通知设置”。

例如,在“通知设置”页上:

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

如果未对关注或参与通知启用“通知方式: 在 GitHub 上”,则通知收件箱不会收到任何更新。

自定义电子邮件通知

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

提示: 如果同时收到网络通知和电子邮件通知,你可以自动同步通知的已读或未读状态,以便在你阅读相应的电子邮件通知后自动将网络通知标记为已读。 要启用此同步,电子邮件客户端必须能够查看来自 notifications@github.com

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

选择一个默认电子邮件地址,用于发送您参与或关注的对话的更新。 还可以指定希望使用默认电子邮件地址接收 GitHub.com 上哪些活动的更新。 例如,选择您的默认电子邮件地址是否要接收以下更新:

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

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

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

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

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

过滤电子邮件通知

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

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

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

标头信息
From 地址此地址始终是'notifications@github.com'。
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 alerts 的电子邮件通知包括 X-GitHub-Severity 标头字段。 可以使用 X-GitHub-Severity 标头字段的值来筛选 Dependabot alerts 的电子邮件通知。 可能的严重程度等级包括:
  • low
  • moderate
  • high
  • critical
有关详细信息,请参阅“关于 Dependabot 警报”。

选择通知设置

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

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

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

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

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

    • 你关注的存储库或参与的对话中有更新。 有关详细信息,请参阅“关于参与和监视通知”。
    • 您获得了新仓库的访问权限或加入了新团队。 有关详细信息,请参阅“自动监视”。
    • 存储库中有新的 Dependabot alerts。 有关详细信息,请参阅“Dependabot alerts 通知选项”。
    • 在使用 GitHub Actions 设置的仓库上有工作流程运行更新。 有关详细信息,请参阅“GitHub Actions 通知选项”。
    • 新部署密钥已添加到属于您作为其所有者的组织的仓库。 有关详细信息,请参阅“组织警报通知选项”。

自动关注

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

“自动关注存储库”和“自动关注团队”切换的屏幕截图。

如果禁用了“Automatically watch repositories(自动关注仓库)”,您将不会自动关注自己拥有的仓库。 您必须导航到仓库页面,然后选择关注选项。

有关详细信息,请参阅“配置通知”。

配置单个仓库的关注设置

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

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

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

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

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

选择接收组织的电子邮件通知的位置

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

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

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

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

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

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

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

  3. 在“默认通知电子邮件”下,选择要用于接收通知的电子邮件地址。

自定义每个组织的电子邮件路由

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

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

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

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

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

  3. 在“默认通知电子邮件”下,单击“自定义路由”。

    “默认通知电子邮件”部分的屏幕截图。 标有“自定义路由”的按钮以橙色轮廓突出显示。

  4. 单击“添加新路由”。

  5. 选择“选取组织”,然后单击要自定义的组织。

  6. 选择一个经验证的电子邮件地址,然后单击“保存”。

    “自定义路由”页的屏幕截图。 显示用户可用电子邮件地址的下拉菜单以橙色边框突出显示。

Dependabot alerts 通知选项

适用于用户帐户的通知选项提供在 https://github.com/settings/notifications 中。 可以在存储库监视设置中为每个存储库配置通知设置。

若要在存储库上接收有关 Dependabot alerts} 的通知,需要监视这些存储库,并订阅以接收“所有活动”通知或配置自定义设置以包括“安全警报”。 有关详细信息,请参阅“配置通知”。 可以选择通知的传递方法,以及通知发送给你的频率。 默认情况下,你将收到通知:

  • 在你的收件箱中,作为 Web 通知。 当为存储库启用 Dependabot、将新的清单文件提交到存储库以及发现具有极高或高严重性的新漏洞时,将发送一条 Web 通知(GitHub 选项)。
  • 通过电子邮件,当为存储库启用 Dependabot、将新的清单文件提交到存储库以及发现具有极高或高严重性的新漏洞时,将发送一封电子邮件(“电子邮件”选项****)。
  • 在命令行上,当你推送到具有任何不安全依赖项的存储库时,警告将显示为回调(“CLI”选项)。
  • 在 GitHub Mobile 上,作为 web 通知。 有关详细信息,请参阅“配置通知”。

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

  • 按存储库:在存储库中启用 Dependabot 时,或者当新的清单文件提交到存储库时。

  • 按组织:当发现新的漏洞时。

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

可以自定义有关 Dependabot alerts 的通知方式。 例如,可以使用“以电子邮件发送每周摘要”选项通过电子邮件接收最多 10 个存储库的每周警报摘要。

有关可用的通知传递方法的详细信息,以及有关针对 Dependabot alerts 优化通知的建议,请参阅“为 Dependabot 警报配置通知”。

Secret scanning 通知选项

当检测到新的机密时,GitHub 会根据用户的通知首选项,通知对存储库安全警报具有访问权限的所有用户。 这些用户包括:

  • 存储库管理员
  • 安全管理员
  • 拥有自定义角色(具有读取/写入访问权限)的用户
  • 组织所有者和企业所有者(如果他们是机密泄露的存储库的管理员)

注意:意外提交机密的提交作者将收到通知(无论其通知首选项如何)。

你将收到电子邮件通知,前提是:

  • 你正在监视存储库。
  • 你已启用存储库上“所有活动”或自定义“安全警报”的通知。
  • 在通知设置中,在“订阅”下,然后在“监视”下,你已选择通过电子邮件接收通知。

若要详细了解如何为 机密扫描警报 配置通知,请参阅“为机密扫描警报配置通知”。

GitHub Actions 通知选项

对于通过 GitHub Actions 设置且在关注的存储库,可以选择如何接收工作流运行更新。

  1. 在“通知设置”页上的“系统”下,然后在“操作”下,选择“不通知”下拉菜单。

    通知设置的“系统”部分的屏幕截图。 在“操作”下,标题为“不通知”的下拉菜单以橙色轮廓突出显示。

  2. 若要选择加入 Web 通知,请从下拉菜单中选择“在 GitHub 上”。

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

  3. (可选)若要仅接收失败工作流运行的通知,请从下拉菜单中选择“仅通知失败的工作流”,然后单击“保存”。

组织警报通知选项

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

使用 GitHub Mobile 管理通知设置

安装 GitHub Mobile 时,您将自动选择 web 通知。 在应用程序中,您可以为以下事件启用推送通知。

  • 直接提及
  • 分配到议题或拉取请求
  • 请求审核拉取请求
  • 请求批准部署

您还可以安排 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 状态时接收通知,或使用“自定义”选项选择要接收其通知的特定事件。