配置通知

通知投递选项

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

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

要在 GitHub 和 GitHub Mobile 上使用通知收件箱，您必须在通知设置中同时启用 电子邮件 和 在 GitHub 上。更多信息，请参见 选择您的通知设置。

通知收件箱的优势

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

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

此外，您还可以使用 GitHub Mobile 在移动设备上接收和分流通知。更多信息，请参见 使用 GitHub Mobile 管理通知设置 或 GitHub Mobile。

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

使用邮件客户端的一个好处是，所有通知都可以根据您的邮件客户端的存储容量无限期保存。除非您将通知标记为 已保存，否则 GitHub 上的收件箱通知仅保留 5 个月。已保存 的通知会永久保留。有关收件箱保留策略的更多信息，请参见 关于通知。

将通知发送到邮件客户端还可以让您根据邮件客户端的设置自定义收件箱，例如使用自定义或彩色标签。

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

关于参与和关注通知

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

要查看您关注的仓库，请前往您的 关注页面。更多信息，请参见 管理 GitHub 活动订阅。

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

关于自定义通知

您可以为仓库自定义通知。例如，您可以选择仅在仓库内发生某些事件类型（Issue、Pull Request、Release、安全警报或讨论）的更新时收到通知，或完全忽略该仓库的所有通知。更多信息，请参见下文的 为单个仓库配置关注设置。

参与对话

任何时候您在对话中发表评论或有人 @ 提及您的用户名，您就在参与该对话。默认情况下，您在参与对话后会自动订阅该对话。您可以通过在 Issue 或 Pull Request 上点击 取消订阅，或在通知收件箱中使用 取消订阅 选项，手动取消对已参与对话的订阅。

对于您正在关注或参与的对话，您可以在通知设置中选择是希望在 GitHub 上接收通知还是通过电子邮件接收。更多信息，请参见 选择您的通知设置。

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

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

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

自定义电子邮件通知

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

如果您使用 Gmail，您可以点击通知电子邮件旁边的按钮，直接访问生成该通知的原始 Issue 或 Pull Request。

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

• 对 Issue 和 Pull Request 的评论
• Pull Request 审核
• Pull Request 推送
• 您自己的更新，例如打开、评论或关闭 Issue 或 Pull Request 时的操作

根据仓库所属的组织，您也可以将通知发送到不同的电子邮件地址。组织可能要求特定域的电子邮件地址经过验证。更多信息，请参见 配置通知。

您也可以将特定仓库的通知发送到某个电子邮件地址。更多信息，请参见 关于向您的仓库推送发送电子邮件通知。

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

如果您所属的组织限制电子邮件通知只能发送到经过批准的电子邮件域，您需要验证该域中的电子邮件地址才能接收组织活动的电子邮件通知。更多信息，请参阅 限制组织的电子邮件通知。

GitHub 发送的每封通知邮件都包含可用于在邮件客户端中过滤通知的标题信息。有关包含的标题信息，请参见 电子邮件通知标题。

回复电子邮件通知

您可以回复来自 GitHub 的电子邮件通知，您的回复将发布到对应的 Issue、Pull Request 或讨论中。

每封通知邮件中的 reply-to 地址标识了对应的线程以及评论将从哪个账户发布。该电子邮件地址在您重置密码之前始终有效。

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

• 标准格式的电子邮件地址（例如 octocat@github.com）会被转换为 ***@***.***。
• 当邮件客户端使用 > 标记签名和引用的回复链时，这些内容会被剔除。
• 尽管电子邮件通知中的取消订阅链接有时会被引用，但只有在登录账户后该链接才能生效。
• 电子邮件附件不会包含在生成的评论中。
• 通过电子邮件回复创建的评论最大长度为 65530 个字符。

选择您的通知设置

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

   

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

   

3. 在通知设置页面，选择接收通知的方式，当

   • 您关注的仓库或您参与的对话有更新时。更多信息，请参见 关于参与和关注通知。
   • 仓库中出现新的 Dependabot 警报时。更多信息，请参见 管理安全通知。
   • 使用 GitHub Actions 设置的仓库出现工作流运行更新时。更多信息，请参见 管理 GitHub Actions 通知。
   • 向您作为所有者的组织所属的仓库添加新部署密钥时。更多信息，请参见 管理组织通知。

为单个仓库配置关注设置

您可以选择是否关注或取消关注单个仓库。您还可以选择仅在特定事件类型（如 Issue、Pull Request、Release、安全警报或讨论（若已为仓库启用））发生时收到通知，或完全忽略单个仓库的所有通知。

1. 在 GitHub 上，导航至仓库的主页面。

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

   如果您想进一步自定义通知，点击 自定义，然后选择您希望收到通知的特定事件，例如 Issue 或 Pull Request，以及参与和 @提及。

   例如，如果您选择 “Issues”，则会收到关于仓库中每个 Issue 的更新通知（包括您选择此选项之前已存在的 Issue），并且如果您在该仓库的 Pull Request 中被 @ 提及，也会收到相应的通知，并订阅该 Pull Request 的更新，此外还会收到 Issue 的通知。

使用 GitHub Mobile 管理通知设置

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

• 直接提及
• 指派 Issue 或 Pull Request
• 请求审查 Pull Request
• 请求批准部署

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

GitHub Enterprise Server 使用后台获取来支持推送通知，因此您可能会在收到推送通知时出现延迟。

使用 iOS 版 GitHub 管理通知设置

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

使用 Android 版 GitHub 管理通知设置

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

使用 GitHub Mobile 为单个仓库配置关注设置

您可以选择是否关注或取消关注单个仓库。您还可以选择仅在特定事件类型（如 Issue、Pull Request、讨论（若已为仓库启用）和新 Release）发生时收到通知，或完全忽略单个仓库的所有通知。

1. 在 GitHub Mobile 中，前往仓库的主页。
2. 点击 关注。
3. 要选择您希望接收通知的活动类型，点击您偏好的关注设置。例如，仅在您参与或被 @ 提及时收到通知，或使用 “自定义” 选项选择具体的事件类型。