如何正確接收 GitHub 的訊息郵件

2020-06-16 17:45:10

背景

我廠的開發流程通常都是基於 GitHub 的。在 GitHub 上 review 程式碼，也是我日常工作的重要組成部分。對我來說，在 code review 過程中最討厭的莫過於，我在 pull request 或 commit 下面評論或 @ 人，往往石沉大海，沒有回音。我事後追問當事人，他們的回復往往是 “不知道你 @ 我了呀～”。

這讓我非常惱火。所以，我決定寫篇文件給所有人看，避免他們漏看重要的 GitHub 訊息。此後在 GitHub 不回復我的人，差不多也可以絕交了罷！

GitHub 的通知機制

通知的型別和方式

在兩種情況下，我們會收到 GitHub 的通知。

我關注的（Watching）：當我關注了某個專案之後，相當於訂閱了這個專案的所有更新，即這個專案的新 release、新 issue、新 PR 及所有討論都會通知我。
我參與的（Participating）：當我參與到某個 issue、PR 或 commit 的討論，或被別人 @ 後，我都會持續收到這個討論的後續更新。

後面一種情況似乎對我更加重要一些。如果不需要密切跟進某個專案，我應該避免關注它。

另外，GitHub 會通過以下兩種方式來通知我們：

站內信（Web）：當我登入 GitHub 網站時，如果有新訊息，在導航欄會看到一個小藍點。點進去就可以看到詳細通知。

站內信收件箱
電子郵件（Email）：通知會直接傳送到我的郵箱，而且我直接回復郵件的效果相當於登入到相關頁面回復，非常方便。

可見，前者是被動方式，提醒能力太弱。而後者是主動推播，時效性好，但我需要注意的就是控制訊息密度，避免被轟炸。因此，接下來，我們來了解一下 GitHub 的 “自動關注” 功能。

自動關注

不錯過重要的訊息，首先意味著不能被無關緊要的訊息湮沒。如果你經常收到大量的 GitHub 訊息，那你可能就全都不看了。因此，我們需要關掉 “自動關注” 功能。

登入 GitHub 通知中心頁面，即可關閉這個功能：

自動關注功能

為什麼要關它？這個功能很有意思，每當你獲得了一個 repo 的 push 許可權之後，GitHub 就會幫你自動關注這個 repo。這在開源社群是很有用的，因為當你獲得了這個許可權時，往往意味著你成為了這個 repo 的核心維護者，你確實需要第一時間掌握這個專案的一舉一動。

但這對於公司內部專案就不那麼合適了。比如我們的主站專案是一個私有 repo，幾乎公司內的每位工程師都會 fork 它；同時出於共同作業的需要，每個 fork 都需要向所有工程師開放讀寫許可權。因此，你將自動關注這近百個 repo，而這些 repo 的任何風吹草動都會通知你，即使你並未真正在其它同事的 fork 上工作。

總之，為了避免無關訊息對你的轟炸，請關掉自動關注功能。你可能已經關注了一堆無關緊要的 fork 了，請記得在你的關注列表頁面逐一取消。（如果你不是核心管理員，建議你把主站專案的 upstream 也取消關注。）