天天看點

一文看懂 Github

一文看懂 Github

GitHub 介紹

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

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

下面将分别介紹 GitHub 的基本内容,如倉庫、分支、送出、請求合并。在這裡以建立 HelloWorld 倉庫為例,并學習 GitHub 的其它内容。

1、建立倉庫

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

建立一個新的倉庫

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

一文看懂 Github

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

3、給倉庫寫一個簡單的描述,幾句話介紹下該項目。

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

一文看懂 Github

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

 2、建立分支

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

下面的圖展示了

1、主分支(master)。

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

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

一文看懂 Github

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

你是否儲存過不同版本的檔案,如:

store.txt

store-zhw-edit.text

store-zhw-edit-reviewed.txt

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

建立一個新的分支

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

2、點選上方檔案清單中的分支 master。

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

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

一文看懂 Github

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

3、修改和送出修改

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

修改和送出修改

1、點選 README.md 檔案。

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

3、在編輯區,寫下關于自己的介紹。

4、填寫送出資訊,描述本次的更新。

5、點選送出變化按鈕。

一文看懂 Github

  

一文看懂 Github

這些更改這是針對目前的 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 按鈕。

一文看懂 Github

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

一文看懂 Github

檢視檔案的變化,確定這些都是你要送出的。

一文看懂 Github

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

一文看懂 Github

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

一文看懂 Github

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

5、合并 Pull Request

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

1、點選綠色按鈕,合并變更到 master。

2、點選确認合并。

一文看懂 Github
一文看懂 Github

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

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

1、建立一個開源項目。

2、建立和合并分支。

3、改變檔案内容,并将變更送出到 GitHub 上。

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

PS:如果覺得文章不錯的話,還請大家點贊分享下,算是對我的最大支援。

推薦閱讀:

Java  學習經驗總結 SSH配置—Linux下實作免密碼登入 Java 學習資料
一文看懂 Github