首頁技術(shù)文章正文

GitHub官網(wǎng)項目使用指南

更新時間:2019年02月12日11時36分來源:github官網(wǎng) 瀏覽次數(shù):

示例項目：Hello World
十分鐘輕松教學(xué)
在學(xué)習(xí)計算機語言編程的過程中創(chuàng)建Hello World 項目是一個歷史悠久的傳統(tǒng)。當(dāng)你接觸一門新事物的時候可以用它來做一個簡單的練習(xí)。讓我們開始使用github吧！
通過本文，您將會學(xué)到：
1.如何創(chuàng)建和使用倉庫
2.如何創(chuàng)建和管理分支
3.如何改變一個文件并將它提交到github上
4.如何發(fā)起以及合并請求
4.什么是GitHub
GitHub是一個代碼版本控制和協(xié)作的托管平臺。它可以讓你和你的伙伴在任何地方一起進行項目開發(fā)。
本教程將幫助你學(xué)習(xí)GitHub的必備知識，如“倉庫”、“分支”、“提交代碼”以及“請求代碼合并”。你將創(chuàng)建你自己的“hello-world”倉庫并且學(xué)習(xí)GitHub的請求代碼合并工作流，這是目前一種非常流行的創(chuàng)建和審查代碼方式。
無需編碼
要完成本教程，您需要注冊一個GitHub賬戶并且需要聯(lián)網(wǎng)。你不需要知道如何編碼，如何使用命令窗口以及如何安裝Git(GitHub的客戶端軟件)。
提示：你可以將本指南在一個單獨的瀏覽器或瀏覽器tab窗口中打開，這樣你就可以邊看著指南邊進行操作了。
第一步：創(chuàng)建一個倉庫
一個倉庫通常用來組織一個單獨的項目。該倉庫可以包含你項目中的所有文件，如文件夾、文件、圖片、視頻、電子表格、數(shù)據(jù)集等。我們建議包含一個README文件，或者你自定義的用來記錄項目信息的文件。GitHub將默認在你創(chuàng)建倉庫的時候添加它。在創(chuàng)建的同時還提供了權(quán)限許可選項。
你可以用你的“hello-world”倉庫來存儲你的想法、資源，甚至用它來和別人分享、討論任何事情。
第一步:創(chuàng)建一個新的倉庫
在頁面的最右上角，你的頭像的左邊，點擊“＋”，在彈出的下拉選項中選擇“New repository”。
在倉庫名稱輸入框中輸入你的倉庫名稱：“hello-world”。
寫一個簡短的描述。
勾選“Initialize this repository with a README”。

點擊“Create repository”按鈕，完成創(chuàng)建。
第二步:創(chuàng)建一個分支
分支是一個可以讓你在同一時間工作在同一個倉庫的不同版本的方法。
在你的倉庫中會有一個默認的名叫“master”的主分支，該分支用來存儲你最終確定的版本代碼。我們用其他的子分支來進行編輯和更改，確定之后再提交到主分支。
當(dāng)你從主分支創(chuàng)建出一個子分支的那一刻，其實你就是對當(dāng)時時間點的主分支做了一個拷貝。如果之后別的分支的人對主分支做出了更新，在你提交到主分支之前，你必須先從主分支上拉取那些更新。
下面的圖表將顯示分支合作的整個流程：
主分支
一個新的命名為“feature”的子分支（因為我們正在這個分支上做開發(fā)）
“feature”分支合并到主分支之前的歷程

你是否像下面這樣保存過不同版本的文件？
story.txt
story-joe-edit.txt
story-joe-edit-reviewed.txt
在GItHub倉庫中的分支就是為了完成類似的功能。
在GitHub上，我們的開發(fā)人員，編輯人員以及設(shè)計人員，分別在獨立的分支上完成自己修改bug或功能編寫的工作。當(dāng)一個功能編寫確定之后，他們就將自己的分支合并到主分支上。
新建一個子分支
進入你的“hello-world”倉庫
點擊文件列表上方的寫著“branch: master”的下拉框
在輸入框中輸入新的分支名字“readme-edits”
點擊下方藍色背景的分支創(chuàng)建框或直接按鍵盤的“Enter”鍵

現(xiàn)在，你已經(jīng)有了“master”和“readme-edits”兩個分支了。他們看起來幾乎一模一樣，但是不要著急，接下來，我們將在我們新建的子分支上做出一些改變。
第三步:做出修改并提交
干得好！現(xiàn)在，你已經(jīng)在你的新分支“readme-edits”上了，讓我們來對它寫點什么。
在GitHub中，保存更改被稱為“提交”。每一次提交都需要寫一段我們?yōu)槭裁醋龀鲂薷牡膫渥⒄f明。這些備注說明將對你的更改做出記錄，其他伙伴看到之后就知道你每次都提交了什么。
做出修改并提交
點擊“README.md”文件，切換到“README.md”內(nèi)容頁面
點擊編輯框右上角的鉛筆按鈕，進入編輯界面
在編輯框中，寫一些你自己的信息
在下方的“提交更改”框中，輸入你做出此次修改的備注說明
點擊下方的“Commit changes”按鈕

這些更改只是針對于位于你的“readme-edits”子分支中的 “README.md ”文件，所以現(xiàn)在這個分支上包含的內(nèi)容和主分支上已經(jīng)有所不同。
第四步:發(fā)出“請求代碼合并”請求
現(xiàn)在你已經(jīng)對你的新分支做出了修改，我們可以發(fā)出“請求代碼合并”的請求啦。
請求代碼合并是GitHub團隊協(xié)作的核心功能。當(dāng)你發(fā)出一個“請求代碼合并”請求的時候，相當(dāng)于你請求別人拷貝你當(dāng)前的代碼做出審查，審查通過之后將你的代碼下載并且合并到他們的分支上。該請求將會在所有的分支上顯示出不相同的部分。你做出的任何更改、增加以及減少，都會用綠色和紅色顯示出來。
在你的代碼完成之前，你可以隨時進行代碼提交，發(fā)起請求代碼合并的請求以及進行一場討論。
你可以通過GitHub的“@”功能，在每次發(fā)出“請求代碼合并”請求的時候，向特定的人或團隊做出反饋，無論這個人是在你身邊還是遠在千里之外。
你可以向自己的倉庫發(fā)出“請求代碼合并”的請求，并且自己去合并他們。這在你接觸到大型項目之前是一個非常好的練習(xí)方法。
為更改的README文件發(fā)出“請求代碼合并”請求
第一步：點擊“Pull Request”選項卡按鈕，切換到請求代碼合并頁面，點擊綠色的“New pull request”按鈕

第二步：選擇你創(chuàng)建的“readme-edits”分支，與主分支進行比較。

第三步：在對比頁面查看這些更改，確定他們就是你想要提交的。

第四步：當(dāng)你確定這些更改就是你所要的時候，點擊綠色的“Create Pull Request”按鈕。

第五步：為你的更改做一個簡單的標題和描述。

當(dāng)你寫完備注描述之后，點擊“Create pull request”按鈕。
提示：你可以使用emoji表情或者拖拽圖片到評論窗口進行評論。
第五步:合并你的“請求代碼合并”請求
這是整個過程的最后一步，是時候?qū)⒛阍谧臃种?ldquo;readme-edits”做出的更改合并到主分支“master”上了。
點擊綠色的“Merge pull request”按鈕，將這些修改合并到主分支
點擊“Confirm merge”按鈕
由于這個分支的更改已經(jīng)被合并了，所以我們還需要點擊紫色框中的“Delete branch”按鈕，刪除這個分支