關於github的入門介紹請參考《GitHub入門與實踐》

本文主要是根據自己在摸索提交pr的程中的一些總結。

簡單過程

首先git分為本地倉庫(自己電腦中)和遠端倉庫(git官網自己的賬號中)，倉庫可以理解為儲存程式碼的地方，簡單的說是在自己本地倉庫修改程式碼，提交到自己遠端倉庫，提交pr後被接受後再會被合併到master。

下面一步一步來。

詳細過程

申請賬號、新增ssh公鑰等過程就不說了哈。

fork

將專案fork到自己的倉庫中，可以在github的首頁搜尋到自己的想要的開源專案，我以flink為例：

進去後，點出fork，稍等片刻，此專案便會出現在自己的倉庫中

進到自己fork的專案中，就能看到Clone or download按鈕，如下，記下這個https連結。

通過上面的步驟，已經將遠端倉庫建好

clone

需要將遠端倉庫clone到本地，此處省略安裝本地github的過程，隨便在哪個目錄(專案存放的目錄)，右鍵開啟一個Git base，執行一下git clone https://github.com/***/***.git(使用上一步的https連結)，等待命令完成，時間視下載速度而定，也許會比較慢，網上也有些可以提高git clone速度的方法，不防一試。

上面的命令完成後，當前目錄下會多一個目錄，我clone的是flink，所以會多一個flink目錄，進到flink目錄中，試試跑一下git status

用git remote -v命令，可以看到此時只與自己的遠端倉庫建立了連線

還需要與上游建立連線，這裡上游指的是一開始fork的那個專案源，以flink為例，執行如下命令：

git remote add upstream https://github.com/apache/flink.git

再用git remote -v可以看到：

接下來就能建立分支了。

建立分支

接著上面的執行命令：git checkout -b flink-fs，這個命令的意思是建立一個叫flink-fs的分支，執行這個命令後bash將自動切換到新的分支下

修改程式碼

自行修改程式碼哈

提交

可以先使用git status來檢視有哪些檔案被修改了

然後再git add ***.java將要提交的檔案都加上

然後再git commit -m "modify XX"，需要注意的是git commit只是把修改的程式碼提交到當前分支(當前分支是flink-fs，而不是master)，”modify XX”是本次提交的簡單說明

然後再git push origin flink-fs，這一步才是將當前分支推送到自己的遠端倉庫。

這時，在自己的遠端倉庫便能看剛才push上去的分支了

提交pr

找到New pull request

需要注意的是compare處選擇剛才提交上來的分支

然後點Create pull request

寫好名字，寫好說明，提交，就OK啦。

關於check不通過的問題

github有程式碼自己編譯和check機制，在你提交pr的時候，專案可能已經有了比較大的變更(每天都有世界各地的coder提pr)，而你沒有將分支保持與專案同步，所以有可能會導致check失敗，pr被無視。

還記得我們在自己本地有一個flink master分支，然後又拉了一個flink-fs分支，然後在flink-fs上進行修改，提交的也是flink-fs，然後又想起了之前有一步是“與上游建立連線”，說到你可能已經知道了master的作用–用於遠端程式碼同步。

所以每次提交pr前，都要先從做程式碼同步。過程如下：

先fetch

再rebase

再push master

push完後，遠端倉庫便可看到你的branch版本和master分支一致了，否則這個位置會顯示與master相差了多少次commit。

做完這些操作，就可以回到之前的詳細過程來操作了。