Learn Git in 30 days—— 第 28 天：瞭解 GitHub 的 fork 與 pull request 版控流程

寫的非常好的一個Git系列文章，強烈推薦

原文鏈接：https://github.com/doggy8088/Learn-Git-in-30-days/tree/master/zh-cn

我們知道 Git 倉庫並沒有什麼「權限控制」的概念，因爲他是分散式的版本控制系統，當你執行 git clone 之後就會把整份擁有完整版本歷史的倉庫下載回來，接着你就可以在本地離線的進行開發與建立版本，最後再將變更推送到遠端倉庫。不過，如果我們只有一份遠端倉庫的話，這代表大家都有權限將變更推送到遠端倉庫。因此，GitHub 採用了 forks 與 pull request 的流程，讓你可以做到基本的權限控制。

設定 GitHub 項目的權限控制 - 個人賬號

在 GitHub 的個人賬戶下，並沒有什麼權限控制的機制，所以只要你授權特定人爲協同開發人員 (Collaborators)，他就能自由的 Push 與 Pull 項目原始碼。

我以我之前在 GitHub 上建立的某個項目爲例，項目網址：https://github.com/doggy8088/DataDictionaryCreator

進入該網址後，點選右側選單的 Settings 連結進入：

然後就可以加入授權的協同開發人員，這裏要輸入的是對方在 GitHub 上的賬號：

設定成功的圖示如下：

但由於你沒辦法設定更細的 Git 遠端倉庫權限，所以只要被指派的人，就能夠存取完整的 Git 遠端倉庫，大家都能對任意分支進行推送 (Push)、拉取 (Pull) 或刪除分支等動作，要是團隊遇上天兵，那可能會是場災難。

設定 GitHub 項目的權限控制 - 組織賬號

在 GitHub 的組織賬戶下，就可以設定人員羣組(Teams)，你就可以在羣組上設定更細的權限，其中包括三種權限：

Pull Only (唯讀)
Push & Pull (可讀可寫)
Push, Pull & Administrative (可讀可寫以及項目管理權限)

設定羣組的方法如下：

然後選擇團隊：

你也可以點選進入組織設定頁面，進一步的來挑選團隊成員：

使用 Fork 功能

英文的 Fork 字面翻譯是「叉子」的意思，就好像你刀叉去把食物「叉」起來一樣，直接把菜挪放到你自己的盤子裏，我比喻的「菜」就是你要複製的 GitHub 項目，而「盤子」就是你的 GitHub 賬號。

注：老外用刀叉比較多，如果 GitHub 是臺灣發展的，這個單字可能會是 Chopsticks (筷子)，哈！ XD

現在我們以 https://github.com/doggy8088/DataDictionaryCreator 爲例，這個項目，你當然沒有「寫入」權限，只有「唯讀」而已。

我現在登入另外一個 GitHub 賬號 ( LearnGitForks )，然後將該項目「叉」到這個賬戶自己 GitHub 賬號下：

按下去之後，他骨子裏其實就是使用 git clone 來複制該項目到你的 GitHub 賬號下，估計只要十幾秒鐘就會複製完成，看你複製的項目大小：

完成後，在你自己的賬號下，就會有個完全一樣的 Git 項目被建立，但會在名稱下顯示一段 forked from 提示你該項目是來從哪裏複製過來的。

因爲該項目已經在你自己的賬號下，所以此時你已經可以把該項目當成「自己的遠端倉庫」在用，完全沒有讀寫權限的問題。

因爲 Git 是個分佈式版本控制系統，只要你有 fetch 的權限，基本上就可以抓到該版本庫的完整版本變更歷程。

使用 Fork 過的 Git 遠端倉庫

在版本控制方面，使用上幾乎跟用自己的 Git 遠端倉庫沒什麼兩樣，而且你也有完整的歷史記錄。請記得這份資料是從 https://github.com/doggy8088/DataDictionaryCreator 複製過來的就好。

我們先取得遠端倉庫回來：

C:\>git clone [email protected]:LearnGitForks/DataDictionaryCreator.git
Cloning into 'DataDictionaryCreator'...
remote: Counting objects: 57, done.
remote: Compressing objects: 100% (45/45), done.
Receiving objects:  71% (41/57), 36.00 KiB | 42.00 KiB/s
Receiving objects: 100% (57/57), 94.08 KiB | 42.00 KiB/s, done.
Resolving deltas: 100% (12/12), done.

C:\>cd DataDictionaryCreator

C:\DataDictionaryCreator>

然後我們建立起一個版本，然後把變更推送回去：

C:\DataDictionaryCreator>echo TEST > test.md

C:\DataDictionaryCreator>git add .

C:\DataDictionaryCreator>git commit -m "Add a test.md for test purpose"
[master b2004b0] Add a test.md for test purpose
 1 file changed, 1 insertion(+)
 create mode 100644 test.md

C:\DataDictionaryCreator>git push
Counting objects: 4, done.
Delta compression using up to 8 threads.
Compressing objects: 100% (2/2), done.
Writing objects: 100% (3/3), 285 bytes | 0 bytes/s, done.
Total 3 (delta 1), reused 0 (delta 0)
To [email protected]:LearnGitForks/DataDictionaryCreator.git
   c29aaab..b2004b0  master -> master

C:\DataDictionaryCreator>

使用 pull request 將變更合併回當初的 GitHub 項目

剛剛我們用 LearnGitForks 身分，把項目從 doggy8088 這邊 Fork 回來，然後用 LearnGitForks 的身分 git clone 回本地端，建立版本後再用 git push 推回 GitHub 的 LearnGitForks 下。

現在我們要把儲存在 LearnGitForks 賬號下的 DataDictionaryCreator 項目「合併」回 doggy8088 賬號下的 DataDictionaryCreator 項目，這時因爲是跨賬號的，所以必須利用 pull request 才能把變更「合併」回去。

注：這裏的 pull request 照字面翻譯是「拉取要求」的意思，代表要以 LearnGitForks 的身分，請 doggy8088 把我的變更給拉回去 (git pull)，但你不能強迫對方拉(pull)，所以必須拜託(request)對方拉，所以才叫做 pull request。

這時，你要用 LearnGitForks 的身分，連到 https://github.com/doggy8088/DataDictionaryCreator 這一頁，然後點選 Pull Requests 頁籤：

然後點選 New pull request 按鈕，準備建立一個新的 pull request 項目：

接下來你要選擇兩個版本 (兩個 commit 物件)，GitHub 才能建立 patch 文件，也才能知道要合併那些東西回去。但你選不到自己 fork 過的版本，因此你要點選 compare across forks

然後你就可以選擇到自己 fork 過的項目與分支了！不過，這一步要特別注意不要選錯，你的版本因爲比較新，所以應該要把右邊的版本選擇成你的，GitHub 才知道從 doggy8088/DataDictionaryCreator 的 master 分支，到 LearnGitForks/DataDictionaryCreator 的 master 分支，到底發生了那些版本變化。

最後你會看到有哪些文件以及哪些地方變更了，然後你就可以按下 Click to create a pull request for this comparison 建立起一個 pull request：

最後，我們先看一下右上角有個 Able to merge 的地方，會預先告訴你合併的結果，顯示你的版本跟目前的 doggy8088:master 的版本是否有衝突發生。如果都沒問題，再輸入一些說明文字給原作者 ( doggy8088 ) ，並按下 Send pull request 即可建立完成。