我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

配置通知

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

本文内容

此文档对您有帮助吗?

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。

通知递送选项

您有三个基本的通知递送选项:

  • the notifications inbox on GitHub
  • 手机版 GitHub 上的通知收件箱,它与 GitHub 上的收件箱同步
  • an email client that uses a verified email address, which can also sync with the notifications inbox on GitHub and 手机版 GitHub

要在 GitHub 和 手机版 GitHub 上使用通知收件箱,必须在通知设置中启用 Web 和移动通知。 更多信息请参阅“选择通知设置”。

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

通知收件箱的优点

The notifications inbox on GitHub and 手机版 GitHub includes triaging options designed specifically for your GitHub notifications flow, including options to:

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

In addition, the notifications inbox on 手机版 GitHub allows you to triage notifications in dark mode and receive push notifications for direct mentions. 更多信息请参阅“为移动版 GitHub 启用推送通知”或“移动版 GitHub”。

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

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

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

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

关于参与和查看通知

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

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

For conversations you're watching or participating in, you can choose whether you want to receive notifications by email or through the notifications inbox on GitHub and 手机版 GitHub.

参与和关注通知选项

例如:

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

If you do not enable watching or participating notifications for web and mobile, then your notifications inbox will not have any updates.

自定义电子邮件通知

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

提示:如果您同时接收 Web 和电子邮件通知,您可以自动同步通知的已读或未读状态,以便在您阅读相应的电子邮件通知后,Web 通知自动标记为已读。 To enable this sync, your email client must be able to view images from 'notifications@github.com'.

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

Gmail 中的按钮

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

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

您还可以向特定仓库的不同电子邮件地址发送通知,具体取决于拥有仓库的组织。 例如,您可以向经验证的个人电子邮件地址发送特定公共仓库的通知。 您的组织可能要求验证特定域的电子邮件地址。 更多信息请参阅“选择接收组织的电子邮件通知的位置”。

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

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

过滤电子邮件通知

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

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

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

标头信息
From 地址This address will always be '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 字段Email notifications for GitHub Dependabot 警报 that affect one or more repositories include the X-GitHub-Severity header field. You can use the value of the X-GitHub-Severity header field to filter email notifications for GitHub Dependabot 警报. 可能的严重程度等级包括:
  • 严重
更多信息请参阅“关于易受攻击的依赖项的警报”。

选择通知设置

  1. 在任何页面的右上角,单击
    表示任何未读消息的通知
  2. 在左侧边栏中的仓库列表下,使用“Manage notifications(管理通知)”下拉按钮单击 Notification settings(通知设置)
    管理通知下拉菜单选项
  3. 在通知设置页面上,选择在以下情况下如何接收通知:

自动关注

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

自动关注选项

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

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

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

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

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

  1. 在任何页面的右上角,单击
    表示任何未读消息的通知
  2. 在左侧边栏中的仓库列表下,使用“Manage notifications(管理通知)”下拉按钮单击 Notification settings(通知设置)
    管理通知下拉菜单选项
  3. 在“Default notification email(默认通知电子邮件)”下,选择要接收通知的电子邮件地址。
    默认通知电子邮件地址下拉菜单
  4. 单击 Save(保存)

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

If you are a member of more than one organization, you can configure each one to send notifications to any of your verified email addresses. For more information, see "Verifying your email address."

  1. 在任何页面的右上角,单击
    表示任何未读消息的通知
  2. 在左侧边栏中的仓库列表下,使用“Manage notifications(管理通知)”下拉按钮单击 Notification settings(通知设置)
    管理通知下拉菜单选项
  3. 在“Custom routing(自定义路由)”下,在列表中找到您组织的名称。
    组织和电子邮件地址列表
  4. 在要更改的电子邮件地址旁边单击 Edit(编辑)
    编辑组织的电子邮件地址
  5. 选择一个经验证电子邮件地址,然后单击 Save(保存)
    切换每个组织的电子邮件地址

GitHub Dependabot 警报 通知选项

You can choose the delivery method for notifications about GitHub Dependabot 警报 on repositories that you are watching, as well as the frequency at which the notifications are sent to you.

By default, you will receive GitHub Dependabot 警报:

  • by email, an email is sent every time a vulnerability is found (Email each time a vulnerability is found option)
  • in the user interface, as warnings in your repository's file and code views (UI alerts option)
  • on the command line, as warnings that are displayed as callbacks when you push to repositories with vulnerabilities (Command Line option)
  • in your inbox, as web notifications (Web option) You can customize the way you are notified about

GitHub Dependabot 警报. For example, you can receive a weekly digest email summarizing alerts for up to 10 of your repositories using the Email a digest summary of vulnerabilities and Weekly security email digest options.

For more information about the notification delivery methods available to you, and advice on optimizing your notifications for GitHub Dependabot 警报, see "Configuring notifications for vulnerable dependencies."

GitHub Actions 通知选项

选择您希望如何接收所关注仓库的工作流程运行更新,通过 GitHub Actions 设置。 您也可以选择仅接收关于失败的工作流程运行的通知。

Dependabot 警报选项

使用 手机版 GitHub 启用推送通知

安装 手机版 GitHub 时,您将自动选择 web 通知。 然后,您可以针对应用程序中的直接提及启用推送通知。

目前,您只能针对 手机版 GitHub 上仓库的推送接收通知。

使用 GitHub for iOS 启用推送通知

  1. 在“Home(主页)”上,点击您的个人资料照片。
  2. 要查看设置,请点击
    iOS 版 GitHub 的设置图标
  3. 要更新通知设置,请点击 Push notifications(推送通知)
  4. 要针对直接提及开启推送通知,请使用 Direct Mentions(直接提及)切换按钮。

使用 GitHub for Android 启用推送通知

  1. 在“Home(主页)”上,点击您的个人资料照片。
  2. 要查看设置,请点击
    Android 版 GitHub 的设置图标
  3. 要针对直接提及开启推送通知,请使用 Direct mentions(直接提及)切换按钮。

此文档对您有帮助吗?

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。