專案指南

GitHub Star、Watch 與 Fork:你該使用哪一種?

想收藏儲存庫時使用 Star,想訂閱動態時使用 Watch,需要獨立儲存庫來修改時則使用 Fork。這些操作解決不同需求,選擇其中一種不代表三種都必須使用。

GitHubStart 編輯團隊 · 更新日期

依照想完成的事情選擇

假設你發現一個實用的 CSV 函式庫。若想稍後閱讀,就給它 Star。若應用程式依賴它,而且你想收到版本更新,請設定 Watch 通知。若打算在自己的儲存庫修改其剖析器,可以考慮 Fork,並遵循該專案的貢獻說明。

  • Star:用來收藏並表達興趣,不是安裝次數。
  • Watch:訂閱儲存庫動態,透過通知設定控制收到的內容。
  • Fork:與原始儲存庫相連的獨立儲存庫,擁有自己的協作空間。

別把收藏和通知混為一談

若已給專案 Star,卻沒有收到版本通知,請檢查 Watch 設定,而不是反覆給 Star。選擇需要的事件,再檢查 GitHub 通知的傳送偏好設定。反過來,若收件匣太吵雜,應檢查訂閱,而不是移除有用的收藏。

只是偶爾查閱的專案,可以先給 Star。對於正式環境中維護的相依套件,則應決定需要檢視哪些更新,以及團隊由誰回應。這樣通知設定就能成為工作流程的一部分,而非人氣指標。

謹慎解讀各項計數

身為維護者,請搭配 Issue 品質、成功完成設定的回報及貢獻情況來看這些計數。Fork 可能只是實驗,最終未必會成為 Pull Request;Star 也可能只是提醒自己回來看,而非已採用。不要把任何一項計數稱為經驗證的活躍使用者人數。

GitHubStart 會為積分制度驗證符合資格的新手動 Star。Watch 或 Fork 儲存庫無法取代這項操作,而且任何操作都不保證其他開發者會給你的專案 Star。

常見問題

給儲存庫 Star 就代表自動 Watch 嗎?

不要將 Star 按鈕當成通知設定。請透過 Watch 及通知偏好設定,選擇想收到的儲存庫動態。

只是想試用專案,也需要 Fork 嗎?

通常可以依照 README,透過下載、套件或 Clone 來試用。當需要自己的儲存庫來修改時,再建立 Fork,並遵循專案文件記載的流程。

GitHub Star 和 GitHubStart 積分一樣嗎?

不一樣。Star 是 GitHub 上的操作;GitHubStart 積分則是獨立帳本紀錄,只有通過其資格及驗證規則才會發放。

參考資料