一文看懂 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、選擇藍色的創建分支框或點擊回車鍵。

 

 

現在有兩個分支,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。

 

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

 

推薦閱讀:

Java  學習經驗總結

SSH配置—Linux下實現免密碼登錄

Java 學習資料

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM