前言

開源這件事情在軟件開發領域一直是一個高頻話題，我們工作中不管是使用到的工具還是第三方庫都離不開開源的支持。

近期由于工作的原因，我需要經常和 Apache Pulsar 社區溝通，同時也會將日常碰到的問題反饋給社區，包括一些 bug ，一些我能修的也是順帶就提了一些 PR。

之前或多或少我也參與過其他的開源社區，但和現在的還是有些許的不同：

• 以前我更多的是個人開源項目，偶爾也會有其他開發者向我的倉庫貢獻代碼。
• 也參與過其他個人作者或者是社區性質的項目，但流程上沒有那么正規或者是標準。

簡單來說就是以前就是小打小鬧，Pulsar 畢竟是 Apache 社區的頂級項目，參與的整個流程要求也會比較復雜，當然學到的知識也會更多。

image.png

這半年時間大大小小提了十幾個 PR ，也逐漸捋清楚了一些上手的方法和套路，所以如果你也想參與開源，但苦于不知道如何入門，看完后希望對你有所幫助。

為什么參與開源

首先還是來聊聊參與開源的好處，了解之后也許會讓你有路轉粉。

首先最明顯的一點就是讓你對貢獻的這個項目更加深入的了解，我們常常都在面試的時候被問到對 XX 框架的熟悉程度，哪怕你在簡歷里寫的天花亂墜也沒有是這個項目 Contributor 更具有說服力。

其次是溝通交流能力也會得到鍛煉，開源社區往往都是以 github issue/PR，或者是 Mailing List 的方式溝通交流，這樣的溝通方式和我們常用的微信、QQ 這類及時通訊工具有著本質的區別。

往往需要我們有了冷靜的思考加上清晰的描述才會將自己的觀點發布出去，這樣不自覺的就會養成自己的總結能力，這個能力對于內容創意內容工作者來說非常重要。

還有一個更明顯的好處就是對個人的能力背書，大家常說的 show me the code，而 GitHub 就是最好的方式。

當你是某個知名開源項目的 Contributor 甚至是 Committer/PMC 就已經足夠證明自己的能力了。

如何參與

如何參與呢，其實也很簡單，不外乎有以下幾種方式（由易到難）：

• 一些 typo 類的修復。
• 回答社區中用戶的問題。
• 使用過程中遇到 bug，直接反饋，有興趣的話最好是自己能修復。
• 修復現有 issue 列表中未解決的 bug。
• 軟件不具備自己需要的功能時提交 feature 提案并實現。

不管是哪種方式我的建議是在準備貢獻之前都應該先看看官方提供的貢獻指南，通常在官網就能查看。

即便是最簡單的修復 typo，因為越是專業的項目每個 PR 的合并都是嚴謹的，提前了解后可以避免犯一些基本錯誤從而影響積極性。

這里我以 Pulsar 為例：

官網有著詳細的貢獻指南，包括環境搭建、代碼約定、PR/git commit 語義等各種規范。

這里我重點強調 PR 的語義，一個好的 PR 規范更容易引起社區成員的注意，畢竟我們每一次提交都需要 Committer 的同意才能合并。

還是以 Pulsar 為例，在提交 PR 前一定得先看看這里的規范要求，不然很可能第一步就會吃癟。

可能遇到的問題

下面講講貢獻過程中可能會碰到的問題。

在上面講到的難度排序中將修復個人 issue 排在了其他 issue 之前了，這是因為往往對自己提交的 bug 更熟悉，而社區其他人反饋的問題大概率會被老手認領。

加上自己也不熟悉，可能在自己研究復現的過程中就把自己勸退了。

認領 issue

這里還有個小技巧，當我們準備修復一個不是自己提交的 issue 時，最好是在評論區讓 Committer 將這個任務分配給你，這樣社區成員就不會做重復工作了。

類似于這樣。

同時我們在查找可以修復的 issue 時也要注意這個 issue 有沒有被認領以及是否有 PR 關聯。

image.png

有時候 issue 并沒有被指定但也有相關 PR 在處理該問題了，這時我們就可以過濾掉這個 issue。

help want

也可以找找帶有 help want 標簽的 issue，這類問題往往會相對簡單，修復起來也更容易。

社區反饋較慢

還有一個比較常見的問題是自己提交的 issue 或者是 PR 遲遲沒有人處理。

我們可以先看看這個 issue 對應的代碼最近主要是哪些人在維護，這個在 IDE 中配合 GitToolBox 插件就很容易看出來。

后面的 ID 往往是 PR 號，我們可以通過這個 PR 找到對應的作者，然后嘗試在 issue 評論區艾特對方。

如果依然沒有回復，那我們也可以給開發組發送郵件。

如果還是沒有回復，比如我這個

那也還有一個辦法，就是嘗試在社交媒體（GitHub 首頁、技術群）上找到 Committer 的微信，直接私聊的方式讓對方幫忙推進。

當然也有一些項目長期沒有維護了，這種 PR 要做好心里準備，很有可能對方不會理你；這點在國內某個企業的開源項目中比較常見。

總結

總的來說想要做好開源得有耐心和長期堅持，同時給自己帶來的好處也是物超所值的，Apache 這類專業的社區我也才參與了半年，后續也會長期堅持下去，也希望哪天可以積累到成為 Committer 后再和大家分享。