示例項(xiàng)目:Hello World
十分鐘輕松教學(xué)
在學(xué)習(xí)計(jì)算機(jī)語(yǔ)言編程的過(guò)程中創(chuàng)建Hello World 項(xiàng)目是一個(gè)歷史悠久的傳統(tǒng)。當(dāng)你接觸一門新事物的時(shí)候可以用它來(lái)做一個(gè)簡(jiǎn)單的練習(xí)。讓我們開始使用github吧!
通過(guò)本文,您將會(huì)學(xué)到:
1.如何創(chuàng)建和使用倉(cāng)庫(kù)
2.如何創(chuàng)建和管理分支
3.如何改變一個(gè)文件并將它提交到github上
4.如何發(fā)起以及合并請(qǐng)求
4.什么是GitHub
GitHub是一個(gè)代碼版本控制和協(xié)作的托管平臺(tái)。它可以讓你和你的伙伴在任何地方一起進(jìn)行項(xiàng)目開發(fā)。
本教程將幫助你學(xué)習(xí)GitHub的必備知識(shí),如“倉(cāng)庫(kù)”、“分支”、“提交代碼”以及“請(qǐng)求代碼合并”。你將創(chuàng)建你自己的“hello-world”倉(cāng)庫(kù)并且學(xué)習(xí)GitHub的請(qǐng)求代碼合并工作流,這是目前一種非常流行的創(chuàng)建和審查代碼方式。
無(wú)需編碼
要完成本教程,您需要注冊(cè)一個(gè)GitHub賬戶并且需要聯(lián)網(wǎng)。你不需要知道如何編碼,如何使用命令窗口以及如何安裝Git(GitHub的客戶端軟件)。
提示:你可以將本指南在一個(gè)單獨(dú)的瀏覽器或?yàn)g覽器tab窗口中打開,這樣你就可以邊看著指南邊進(jìn)行操作了。
第一步:創(chuàng)建一個(gè)倉(cāng)庫(kù)
一個(gè)倉(cāng)庫(kù)通常用來(lái)組織一個(gè)單獨(dú)的項(xiàng)目。該倉(cāng)庫(kù)可以包含你項(xiàng)目中的所有文件,如文件夾、文件、圖片、視頻、電子表格、數(shù)據(jù)集等。我們建議包含一個(gè)README文件,或者你自定義的用來(lái)記錄項(xiàng)目信息的文件。GitHub將默認(rèn)在你創(chuàng)建倉(cāng)庫(kù)的時(shí)候添加它。在創(chuàng)建的同時(shí)還提供了權(quán)限許可選項(xiàng)。
你可以用你的“hello-world”倉(cāng)庫(kù)來(lái)存儲(chǔ)你的想法、資源,甚至用它來(lái)和別人分享、討論任何事情。
第一步:創(chuàng)建一個(gè)新的倉(cāng)庫(kù)
在頁(yè)面的最右上角,你的頭像的左邊,點(diǎn)擊“+”,在彈出的下拉選項(xiàng)中選擇“New repository”。
在倉(cāng)庫(kù)名稱輸入框中輸入你的倉(cāng)庫(kù)名稱:“hello-world”。
寫一個(gè)簡(jiǎn)短的描述。
勾選“Initialize this repository with a README”。
點(diǎn)擊“Create repository”按鈕,完成創(chuàng)建。
第二步:創(chuàng)建一個(gè)分支
分支是一個(gè)可以讓你在同一時(shí)間工作在同一個(gè)倉(cāng)庫(kù)的不同版本的方法。
在你的倉(cāng)庫(kù)中會(huì)有一個(gè)默認(rèn)的名叫“master”的主分支,該分支用來(lái)存儲(chǔ)你最終確定的版本代碼。我們用其他的子分支來(lái)進(jìn)行編輯和更改,確定之后再提交到主分支。
當(dāng)你從主分支創(chuàng)建出一個(gè)子分支的那一刻,其實(shí)你就是對(duì)當(dāng)時(shí)時(shí)間點(diǎn)的主分支做了一個(gè)拷貝。如果之后別的分支的人對(duì)主分支做出了更新,在你提交到主分支之前,你必須先從主分支上拉取那些更新。
下面的圖表將顯示分支合作的整個(gè)流程:
主分支
一個(gè)新的命名為“feature”的子分支(因?yàn)槲覀冋谶@個(gè)分支上做開發(fā))
“feature”分支合并到主分支之前的歷程
你是否像下面這樣保存過(guò)不同版本的文件?
story.txt
story-joe-edit.txt
story-joe-edit-reviewed.txt
在GItHub倉(cāng)庫(kù)中的分支就是為了完成類似的功能。
在GitHub上,我們的開發(fā)人員,編輯人員以及設(shè)計(jì)人員,分別在獨(dú)立的分支上完成自己修改bug或功能編寫的工作。當(dāng)一個(gè)功能編寫確定之后,他們就將自己的分支合并到主分支上。
新建一個(gè)子分支
進(jìn)入你的“hello-world”倉(cāng)庫(kù)
點(diǎn)擊文件列表上方的寫著“branch: master”的下拉框
在輸入框中輸入新的分支名字“readme-edits”
點(diǎn)擊下方藍(lán)色背景的分支創(chuàng)建框或直接按鍵盤的“Enter”鍵
現(xiàn)在,你已經(jīng)有了“master”和“readme-edits”兩個(gè)分支了。他們看起來(lái)幾乎一模一樣,但是不要著急,接下來(lái),我們將在我們新建的子分支上做出一些改變。
第三步:做出修改并提交
干得好!現(xiàn)在,你已經(jīng)在你的新分支“readme-edits”上了,讓我們來(lái)對(duì)它寫點(diǎn)什么。
在GitHub中,保存更改被稱為“提交”。每一次提交都需要寫一段我們?yōu)槭裁醋龀鲂薷牡膫渥⒄f(shuō)明。這些備注說(shuō)明將對(duì)你的更改做出記錄,其他伙伴看到之后就知道你每次都提交了什么。
做出修改并提交
點(diǎn)擊“README.md”文件,切換到“README.md”內(nèi)容頁(yè)面
點(diǎn)擊編輯框右上角的鉛筆按鈕,進(jìn)入編輯界面
在編輯框中,寫一些你自己的信息
在下方的“提交更改”框中,輸入你做出此次修改的備注說(shuō)明
點(diǎn)擊下方的“Commit changes”按鈕
這些更改只是針對(duì)于位于你的“readme-edits”子分支中的 “README.md ”文件,所以現(xiàn)在這個(gè)分支上包含的內(nèi)容和主分支上已經(jīng)有所不同。
第四步:發(fā)出“請(qǐng)求代碼合并”請(qǐng)求
現(xiàn)在你已經(jīng)對(duì)你的新分支做出了修改,我們可以發(fā)出“請(qǐng)求代碼合并”的請(qǐng)求啦。
請(qǐng)求代碼合并是GitHub團(tuán)隊(duì)協(xié)作的核心功能。當(dāng)你發(fā)出一個(gè)“請(qǐng)求代碼合并”請(qǐng)求的時(shí)候,相當(dāng)于你請(qǐng)求別人拷貝你當(dāng)前的代碼做出審查,審查通過(guò)之后將你的代碼下載并且合并到他們的分支上。該請(qǐng)求將會(huì)在所有的分支上顯示出不相同的部分。你做出的任何更改、增加以及減少,都會(huì)用綠色和紅色顯示出來(lái)。
在你的代碼完成之前,你可以隨時(shí)進(jìn)行代碼提交,發(fā)起請(qǐng)求代碼合并的請(qǐng)求以及進(jìn)行一場(chǎng)討論。
你可以通過(guò)GitHub的“@”功能,在每次發(fā)出“請(qǐng)求代碼合并”請(qǐng)求的時(shí)候,向特定的人或團(tuán)隊(duì)做出反饋,無(wú)論這個(gè)人是在你身邊還是遠(yuǎn)在千里之外。
你可以向自己的倉(cāng)庫(kù)發(fā)出“請(qǐng)求代碼合并”的請(qǐng)求,并且自己去合并他們。這在你接觸到大型項(xiàng)目之前是一個(gè)非常好的練習(xí)方法。
為更改的README文件發(fā)出“請(qǐng)求代碼合并”請(qǐng)求
第一步:點(diǎn)擊“Pull Request”選項(xiàng)卡按鈕,切換到請(qǐng)求代碼合并頁(yè)面,點(diǎn)擊綠色的“New pull request”按鈕
第二步:選擇你創(chuàng)建的“readme-edits”分支,與主分支進(jìn)行比較。
第三步:在對(duì)比頁(yè)面查看這些更改,確定他們就是你想要提交的。
第四步:當(dāng)你確定這些更改就是你所要的時(shí)候,點(diǎn)擊綠色的“Create Pull Request”按鈕。
第五步:為你的更改做一個(gè)簡(jiǎn)單的標(biāo)題和描述。
當(dāng)你寫完備注描述之后,點(diǎn)擊“Create pull request”按鈕。
提示:你可以使用emoji表情或者拖拽圖片到評(píng)論窗口進(jìn)行評(píng)論。
第五步:合并你的“請(qǐng)求代碼合并”請(qǐng)求
這是整個(gè)過(guò)程的最后一步,是時(shí)候?qū)⒛阍谧臃种?ldquo;readme-edits”做出的更改合并到主分支“master”上了。
點(diǎn)擊綠色的“Merge pull request”按鈕,將這些修改合并到主分支
點(diǎn)擊“Confirm merge”按鈕
由于這個(gè)分支的更改已經(jīng)被合并了,所以我們還需要點(diǎn)擊紫色框中的“Delete branch”按鈕,刪除這個(gè)分支
大功告成,你已經(jīng)學(xué)會(huì)如何在github官網(wǎng)上管理自己的項(xiàng)目了。