碼農朋友們都知道,gitHub是一個面向開源及私有軟體專案的託管平臺,上面託管了眾多的優秀的專案,比如linux核心原始碼、git原始碼、機器學習框架tensorflow等等。當然,除了這些頂尖專案外,還有海量的高手開發的優秀專案。所有的這些專案,我們都可以為它貢獻程式碼。
那麼,要如何為這些專案貢獻程式碼呢?我們下面以例項來講解。
比如說,現在gitHub上有個很牛逼的專案githubTest,它的作者是Alvin,專案地址如下:
https://github.com/yychuyu/githubTest
複製程式碼
現在Harry看到了這個專案,想要對它進行貢獻程式碼。想要達到這個目的,Harry要完成下圖的這些步驟:
1. fork
Harry在找到這個專案之後,點選右上角的「fork」按鈕。稍等片刻後,就會在Harry的賬號下克隆了一個一樣的專案githubTest,包括檔案,提交歷史,issues,和其餘一些東西。
2. clone
通過fork之後,Harry的賬號下也有了githubTest這個專案,但還不能對它進行編譯、修改(其實是可以修改,但是不建議)。
這時,可以通過git clone命令,將這個專案clone到自己的電腦裡。
3. update a file & 4. commit
接下來,Harry就可以大顯身手了,可以自由對這個專案進行修改。但是,不建議在master分支直接修改,建議在master分支基礎上切出一個dev分支,然後在dev分支上自由發揮。修改完之後,再將dev分支merge到master分支。
5. push
在自己的電腦上修改好程式碼之後,再使用git push命令將改動同步到自己的gitHub專案倉庫裡。
通過這個操作後,就可以在程式碼倉庫裡看到自己的提交了。
6. pull request
接下來,就是向原作者Alvin提交你的程式碼了。首先點選檔案列表上的「New pull request」。
之後,gitHub會自動對源倉庫分支及自己倉庫分支程式碼進行比對,看看是否有衝突。如果它顯示「Able to merge」的話,Harry就可以點選下面的「Create pull request」綠色按鈕,進行程式碼提交。
再之後,系統會要求你寫一段註釋,其實也可不寫。但最好寫一下,跟作者說明一下你改動了什麼,為啥這麼改。
通過以上6步,原作者Alvin就會收到一個pull request,如下圖:
然後,Alvin可以點進去,看看Harry具體提交了一些什麼修改。如果他覺得這個修改確實夠niubility的話,它就可以點選「merge pull request」,將Harry的提交整合到自己的專案裡。
至此,功德圓滿,Harry順利完成一次對專案githubTest的程式碼貢獻。
但是,這個專案實在太出眾了,很多高手看到了並貢獻了眾多程式碼。比如現在Alvin自己提交了一個檔案:
現在原作者專案已經發生了改變,那Harry賬號下的githubTest如何與原作者Alvin的專案保持同步呢?Harry需要做以下三步操作:
1. fetch
現在程式碼不同步了,我們要先把Alvin倉庫的程式碼fetch到自己電腦的倉庫下。注意,這是在自己電腦上操作,不是在github上操作。
git fetch git@github.com:yychuyu/githubTest.git master:latest
複製程式碼
上面這條命令,git fetch 之後 的那部分,是原作者Alvin專案git地址,通過點選原專案「clone or download」按鈕可以看到。再之後master:latest這部分,master是原專案分支,latest是自己專案分支。如果latest分支不存在的話,將自動建立。其實也可以將程式碼fetch到自己的master分支,但也不建議這麼做。
2. merge
程式碼fetch到latest分支之後,再切到master分支,再使用git merge命令將最新程式碼合併到master分支。
3. push
現在,Harry電腦上的程式碼與原專案程式碼保持同步了。我們再使用git push命令,就可以將最新程式碼推到Harry賬號下githubTest專案裡
以上的三個步驟具體操作過程如下圖示。
接下來,Harry就可以在此基礎上,繼續貢獻自己的程式碼了。
更多精彩內容,請關注公眾號良許Linux,公眾內回覆1024可免費獲得5T技術資料,包括:Linux,C/C++,Python,樹莓派,嵌入式,Java,人工智慧,等等。公眾號內回覆進群,邀請您進高手如雲技術交流群。