上游 · 理解本功能前需先掌握的(1):
下游 · 依赖/承接本功能的(0):
暂无下游(建议学完它再进阶)
前置依赖包含从属概念升级流程承接
边方向 = 学习顺序(A→B 表示先学 A 再学 B)
为什么需要它
心智模型
仓库里有人评论你的 Issue、你的 PR 有新进展、新版本发布了……如果全靠自己刷页面,肯定错过。Notifications 像一个「专属消息收件箱」,把和你相关的动态自动推给你,你只处理要紧的,不打扰的可以关掉。
历史背景 · 它为什么诞生诞生于 2019
诞生GitHub早期仅邮件通知,信息过载且无法区分重要程度。2019-11-12推出重新设计的notifications beta,提供网页通知中心,可快速triage/响应/清理收件箱,并明确'参与(participating)vs关注(watching)'的订阅语义。
功能介绍
Notifications 是 GitHub 的通知中心,用来接收你参与的仓库和事件的消息。它关注的是「和你有关」的动态,比如:有人 @ 提到你、有人评论了你创建的 Issue 或 Pull Request、你 watch(关注)的仓库有新发布(Release)或新讨论,以及 Actions 流水线的结果提醒。通知会推送到 GitHub 网页右上角的铃铛图标、注册邮箱,也可以在设置里关联到手机或 Slack。你可以通过 watch(订阅)一个仓库来决定是否接收它的通知,watch 和 star 的区别要分清:star 只是「收藏点赞」,不会给你发消息;watch 才是「订阅动态」,会持续推送。通知支持自定义偏好:哪些类型要、哪些渠道收、哪些仓库静音,还支持「mark all as read」(全部标为已读)。
核心术语
通知中心(Notifications)订阅 / 关注(Watch)收藏(Star)提及(Mention)发布(Release)标记为已读(Mark as Read)
适用场景
- 当你想第一时间知道有人评论了你的 Issue 或 PR 时
- 当你 watch 了某个仓库、希望收到它的新版本发布提醒时
- 当通知太多打扰你、想静音某几个仓库时
- 当你想把通知收进邮件而不是每次刷网页时
怎么操作(网页 vs 命令行 双轨)
🖱️ 网页操作 (GitHub.com)
- 点击 GitHub 页面右上角的铃铛图标,进入通知收件箱,可筛选「Inbox 未读 / Done 已处理」
- 打开某个仓库页面,点击 Watch 按钮选择 All / Participating / Ignore 来控制订阅强度
- 在 Settings → Notifications 里设置通知渠道(网页、邮件、Slack)和各类型偏好
⌨️ 命令行 (进阶)
`gh api /notifications` # 查看你的未读通知`gh api -X PUT /notifications -f "read=true"` # 把全部通知标为已读
新手建议先从网页操作入手,熟悉概念后再尝试命令行。命令行是真实开发中更常用的方式。
与其他功能的关系
| 关系(前置依赖 / 包含从属 / 概念升级 / 流程承接) | 说明 |
|---|---|
| 概念升级Star 与 Watch(Star & Watch) | 订阅关注后接收通知,watch 直接关联通知 |
官方文档
小结
SUMMARY
Notifications 是你的 GitHub 消息收件箱,watch 决定订阅、star 只是收藏,还能按渠道和类型定制提醒强度。下一步:点右上角铃铛看看收件箱,再决定要 watch 哪些重要仓库。