一文看懂 Github

dotzhang發表於2018-06-11

一文看懂 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

這些更改這是針對當前的 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


相關文章