GitHub使用教程詳解——官網操作指南(翻譯)


GitHub使用指南

原文地址:GitHub官網

示例項目:Hello World

十分鍾輕松教學

在學習計算機語言編程的過程中創建Hello World 項目是一個歷史悠久的傳統。當你接觸一門新事物的時候可以用它來做一個簡單的練習。讓我們開始使用github吧!

通過本文,您將會學到:

  1. 如何創建和使用倉庫
  2. 如何創建和管理分支
  3. 如何改變一個文件並將它提交到github上
  4. 如何發起以及合並請求

什么是GitHub

GitHub是一個代碼版本控制和協作的托管平台。它可以讓你和你的伙伴在任何地方一起進行項目開發。

本教程將幫助你學習GitHub的必備知識,如“倉庫”、“分支”、“提交代碼”以及“請求代碼合並”。你將創建你自己的“hello-world”倉庫並且學習GitHub的請求代碼合並工作流,這是目前一種非常流行的創建和審查代碼方式。

無需編碼

要完成本教程,您需要注冊一個GitHub賬戶並且需要聯網。你不需要知道如何編碼,如何使用命令窗口以及如何安裝Git(GitHub的客戶端軟件)。

提示:你可以將本指南在一個單獨的瀏覽器或瀏覽器tab窗口中打開,這樣你就可以邊看着指南邊進行操作了。

第一步:創建一個倉庫

一個倉庫通常用來組織一個單獨的項目。該倉庫可以包含你項目中的所有文件,如文件夾、文件、圖片、視頻、電子表格、數據集等。我們建議包含一個README文件,或者你自定義的用來記錄項目信息的文件。GitHub將默認在你創建倉庫的時候添加它。在創建的同時還提供了權限許可選項。

你可以用你的“hello-world”倉庫來存儲你的想法、資源,甚至用它來和別人分享、討論任何事情。

第一步:創建一個新的倉庫

  1. 在頁面的最右上角,你的頭像的左邊,點擊“+”,在彈出的下拉選項中選擇“New repository”。
  2. 在倉庫名稱輸入框中輸入你的倉庫名稱:“hello-world”。
  3. 寫一個簡短的描述。
  4. 勾選“Initialize this repository with a README”。

點擊“Create repository”按鈕,完成創建。

第二步:創建一個分支

分支是一個可以讓你在同一時間工作在同一個倉庫的不同版本的方法。

在你的倉庫中會有一個默認的名叫“master”的主分支,該分支用來存儲你最終確定的版本代碼。我們用其他的子分支來進行編輯和更改,確定之后再提交到主分支。

當你從主分支創建出一個子分支的那一刻,其實你就是對當時時間點的主分支做了一個拷貝。如果之后別的分支的人對主分支做出了更新,在你提交到主分支之前,你必須先從主分支上拉取那些更新。

下面的圖表將顯示分支合作的整個流程:

主分支
一個新的命名為“feature”的子分支(因為我們正在這個分支上做開發)
“feature”分支合並到主分支之前的歷程

你是否像下面這樣保存過不同版本的文件?

story.txt
story-joe-edit.txt
story-joe-edit-reviewed.txt
在GItHub倉庫中的分支就是為了完成類似的功能。

在GitHub上,我們的開發人員,編輯人員以及設計人員,分別在獨立的分支上完成自己修改bug或功能編寫的工作。當一個功能編寫確定之后,他們就將自己的分支合並到主分支上。

新建一個子分支

  1. 進入你的“hello-world”倉庫
  2. 點擊文件列表上方的寫着“branch: master”的下拉框
  3. 在輸入框中輸入新的分支名字“readme-edits”
  4. 點擊下方藍色背景的分支創建框或直接按鍵盤的“Enter”鍵

現在,你已經有了“master”和“readme-edits”兩個分支了。他們看起來幾乎一模一樣,但是不要着急,接下來,我們將在我們新建的子分支上做出一些改變。

第三步:做出修改並提交

干得好!現在,你已經在你的新分支“readme-edits”上了,讓我們來對它寫點什么。

在GitHub中,保存更改被稱為“提交”。每一次提交都需要寫一段我們為什么做出修改的備注說明。這些備注說明將對你的更改做出記錄,其他伙伴看到之后就知道你每次都提交了什么。

做出修改並提交

  1. 點擊“README.md”文件,切換到“README.md”內容頁面
  2. 點擊編輯框右上角的鉛筆按鈕,進入編輯界面
  3. 在編輯框中,寫一些你自己的信息
  4. 在下方的“提交更改”框中,輸入你做出此次修改的備注說明
  5. 點擊下方的“Commit changes”按鈕

這些更改只是針對於位於你的“readme-edits”子分支中的 “README.md ”文件,所以現在這個分支上包含的內容和主分支上已經有所不同。

第四步:發出“請求代碼合並”請求

現在你已經對你的新分支做出了修改,我們可以發出“請求代碼合並”的請求啦。

請求代碼合並是GitHub團隊協作的核心功能。當你發出一個“請求代碼合並”請求的時候,相當於你請求別人拷貝你當前的代碼做出審查,審查通過之后將你的代碼下載並且合並到他們的分支上。該請求將會在所有的分支上顯示出不相同的部分。你做出的任何更改、增加以及減少,都會用綠色和紅色顯示出來。

在你的代碼完成之前,你可以隨時進行代碼提交,發起請求代碼合並的請求以及進行一場討論。

你可以通過GitHub的“@”功能,在每次發出“請求代碼合並”請求的時候,向特定的人或團隊做出反饋,無論這個人是在你身邊還是遠在千里之外。

你可以向自己的倉庫發出“請求代碼合並”的請求,並且自己去合並他們。這在你接觸到大型項目之前是一個非常好的練習方法。

為更改的README文件發出“請求代碼合並”請求

第一步:點擊“Pull Request”選項卡按鈕,切換到請求代碼合並頁面,點擊綠色的“New pull request”按鈕

第二步:選擇你創建的“readme-edits”分支,與主分支進行比較。

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

第四步:當你確定這些更改就是你所要的時候,點擊綠色的“Create Pull Request”按鈕。

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

當你寫完備注描述之后,點擊“Create pull request”按鈕。

提示:你可以使用emoji表情或者拖拽圖片到評論窗口進行評論。

第五步:合並你的“請求代碼合並”請求

這是整個過程的最后一步,是時候將你在子分支“readme-edits”做出的更改合並到主分支“master”上了。

  1. 點擊綠色的“Merge pull request”按鈕,將這些修改合並到主分支
  2. 點擊“Confirm merge”按鈕
  3. 由於這個分支的更改已經被合並了,所以我們還需要點擊紫色框中的“Delete branch”按鈕,刪除這個分支

大功告成,你已經學會如何在github官網上管理自己的項目了。


免責聲明!

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



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