一文看懂 Github

GitHub 介紹

GitHub 是為開發者構建的一個開發平臺。GitHub 是一個受開發者工作方式啟發的開發平臺，從開源到商業，能夠在上面進行託管和檢視程式碼、管理專案和數百萬其他開發人員一起開發軟體。GitHub 提供免費賬戶和付費賬戶，免費賬戶只能建立開源的專案，付費賬戶可以建立私有專案。對學生有一定的福利，如果你是學生的話，可以用學校分配的郵箱在官網進行申請，申請通過之後，也能夠建立私有專案。

要完成本教程，你需要一個 GitHub 帳戶，可以在官網進行註冊。

下面將分別介紹 GitHub 的基本內容，如倉庫、分支、提交、請求合併。在這裡以建立 HelloWorld 倉庫為例，並學習 GitHub 的其它內容。

1、建立倉庫

倉庫通常用於組織單個專案。倉庫可以包含資料夾和檔案、圖片、視訊呢、電子表格和資料集以及專案需要的任何東西。每個倉庫下面都推薦有一個 README 檔案，或者是一個包含專案資訊的檔案。可以在倉庫中儲存想法、資源，甚至可以與其他人共享和討論問題。

建立一個新的倉庫

1、在左邊的欄目中或者頭像旁邊點選 +，然後點選新建倉庫。

2、倉庫的名稱，我們設定為 HelloWorld。

3、給倉庫寫一個簡單的描述，幾句話介紹下該專案。

4、選擇初始化倉庫的時候，建立 README 檔案。

5、點選建立倉庫，完成倉庫的建立。

2、建立分支

分支是一次處理不同版本倉庫的一種方式。預設情況下，倉庫下面有一個名為 master 的分支，這是我們的主分支，也是最終的版本。我們使用其它分支來進行實驗，在提交到主分支的之前，我們可以對分支進行編輯等操作。當我們在主分支上建立一個分支時，相當於我們從主分支上的複製或者是快照，這樣當我們在自己的分支上工作時，如果其他人對主分支進行了更改，我們可以通過 Pull 操作來更新程式碼。每個分支都是獨立的，一個專案可以有多個分支，每個人開發屬於自己的一個模組，最後統一合併到主分支。

下面的圖展示了

1、主分支（master）。

2、新的分支，名字叫 feature，每個分支都是對功能的擴充套件。

3、feature 分支被 master 合併的整個過程。

當你在主分支上建立一個分支時，相當於複製，或者快照。如果你在分支上工作時，其他人對主分支進行了更改，你可以通過 pull，進行更新到最新的程式碼。

你是否儲存過不同版本的檔案，如：

store.txt
store-zhw-edit.text
store-zhw-edit-reviewed.txt

分支就是用來解決這樣的事情，在 GitHub 上，開發人員、作者和設計人員使用分支將 bug 修復和開發功能與我們的主分支分開，當一個變更準備好了，我們就將對應的分支合併到主分支。

建立一個新的分支

1、進到我們剛才建立的 HelloWorld 倉庫。

2、點選上方檔案列表中的分支 master。

3、在新的分支文字框中輸入一個分支名稱，readme-edits。

4、選擇藍色的建立分支框或點選Enter鍵。

現在有兩個分支，master 和 readme-edits。它們看起來完全一樣，但不會太久! 接下來，我們將新增對新分支的更改。

3、修改和提交修改

我們現在所在的 readme-edits 分支，這是一個 master 的副本，接下來讓我們做一些編輯。在 GitHub 上，儲存的更改稱為提交，每個提交都有一個關聯的提交訊息，這是對你做的修改進行描述，當你提交了更改，其他的貢獻者通過描述可以知道你做了什麼。

修改和提交修改

1、點選 README.md 檔案。

2、點選右邊的第二個鉛筆圖示進行修改。

3、在編輯區，寫下關於自己的介紹。

4、填寫提交資訊，描述本次的更新。

5、點選提交變化按鈕。

這些更改這是針對當前的 readme-edits 分支中的 README 檔案，現在這個分支包含的內容與 master 上的內容是不同的。

4、請求合併分支（PR）

現在我們已經更改了分支，可以對主分支進行 Pull Request。Pull Request 是 GitHub 上合作的核心，當你發出一個 Pull Request 時，你是在提出你的變更，請求別人審查並將你做出的改變（貢獻）合併到他們的分支中。Pull Request 顯示來自兩個分支內容的差異，這些變化，增加的內容以綠色來表示，減少的內容以紅色來表示。

當你完成工作時，你可以進行提交，通過提出 Pull Request 並開始討論，你可以在 Pull Request 時，使用 @，請求特定的人員或團隊來稽核。

為改變過的 README 檔案，開啟 Pull Request

1、點選 Pull Request 選項，然後在 Pull Request 頁面，點選綠色的 New Pull Request 按鈕。

選擇我們建立的分支，readme-edits，以便與 master 進行比較。

檢視檔案的變化，確保這些都是你要提交的。

當檢查好了之後，並沒有任何錯誤，可以點選這個綠色的按鈕，建立一個 Pull Request。

點選之後，給出本次 Pull Request 的 title 和描述。

以上都完成之後，點選綠色按鈕建立。

5、合併 Pull Request

在這最後一步，是將之前的變更合併到主分支上，也就是將 readme-edits 分支合併到 master 分支上。

1、點選綠色按鈕，合併變更到 master。

2、點選確認合併。

到這裡你已經學會了在 GitHub 上建立倉庫和怎麼在別人的專案中貢獻自己的一份力量。

你在本次學習中完成了下面的作業。

1、建立一個開源專案。

2、建立和合並分支。

3、改變檔案內容，並將變更提交到 GitHub 上。

4、提出 Pull Requet 和合並一個 Pull Request。