如何利用GitHub進行源代碼管理

       GitHub 是一個面向開源及私有軟件項目的托管平台，因為只支持 Git 作為唯一的版本庫格式進行托管，故名 GitHub。GitHub 於 2008 年 4 月 10 日正式上線，除了 Git代碼倉庫托管及基本的 Web 管理界面以外，還提供了訂閱、討論組、文本渲染、在線文件編輯器、協作圖譜（報表）、代碼片段分享（Gist）等功能。本篇博客將會着重介紹利用GitHub的倉庫功能，進行項目源代碼管理的一些使用方法。

一、注冊GitHub

  （1）初始界面，填寫用戶名，郵箱，密碼，點擊sign up。

 

（2）當驗證賬戶成功后，會向你的郵箱發送一份郵件，確認后點擊join a free plan。

（3）跳轉到個人主頁，注冊就完成了。

 

二、GitHub代碼倉庫。

（1）創建倉庫。 

點擊個人主頁右上角的加號，選擇New repository(新倉庫）。

 

填寫新倉庫的名字，我們組的項目和智能魚有關，所以名字取了new-fish。

Description（描述）可寫可不寫，根據需要即可。至於是Public還是Private看自己團隊的需要使用，如果說是十分私密的關鍵項目就可以用Private，只能由創建此倉庫的人選擇誰可以看，如果是普通的項目就用Public就行了。

下面的選項的意思是允許將你倉庫的克隆下載至你的電腦，建議勾選。如果你的倉庫需要導入其他倉庫，那就不用勾選。

add.gitignore用於在提交項目文件時過濾一些不需要的文件。比如你的項目文件夾下包含了很多.o和.cpp文件，但我只想提交.cpp文件，那就可以用到這個選項只選C++。我們項目以java代碼寫的，所以選擇了java。

add a license右側的下拉菜單可以選擇需要添加的許可協議文件。具體協議的作用請參考https://www.oschina.net/news/27273/main-os-license-comparison。

 

   創建完成。

 

（2）添加文件

第一種方法：點擊右上角的Create new file(初次使用的用戶或是沒有寫描述的用戶可能創建完倉庫的首頁會出現下面左圖的情況，也是點擊Create new file，只是位置有些不同）

 

點擊后跳轉至此頁面

填寫文件名（最好不要用中文）

右側三個選項，第一個是指縮進方式，可以使用空格和tab。第二個是縮進大小2、4、8字符。第三個是代碼縮進，可選不縮進或是軟件縮進。

下方是文件描述，第一個空是簡單的描述。第二個大空，是額外的具體描述。

最下方的選項，第一個是作為項目的主干，直接放入項目文檔中。

第二個是作為一個主干的分支，分支是GitHub最重要也是有用的功能，具體解釋和操作可以參考https://blog.csdn.net/pdw_jsp/article/details/81318626。

 

 

創建成功會顯示在倉庫里。

 

 第二種方法（比較常用）：利用git客戶端，實現本地倉庫與遠程倉庫連接。

（1）在官網或其他鏡像網站下載git，並安裝完成。

（2）設置克隆倉庫保存路徑。（不同git版本可能有所不同，保存路徑的文件夾必須為空，一個倉庫占一個空文件夾）

 

 

 

建議先在Github網站上創建遠程倉庫，這樣的話如果要克隆自己的倉庫直接在GitHub.com下選擇，克隆別人的需要獲取他的倉庫的URL，URL在遠程倉庫主頁的右側，綠色按鈕點開，彈窗中間的就是URL。

 

 

 

 

 克隆完成后主界面

 

 打開克隆路徑，添加想要上傳的文件

 

 

返回客戶端，會自動檢查變化，點擊發布。

 

 

 檢測到本地克隆的數據庫與遠程數據庫有一個文件不同，猜測你想將這個文件上傳至GitHub，點擊Push。

 

 等待它同步完成，GitHub上的遠程倉庫顯示上傳完成了，內容與你本地txt文件的內容相同。本地的倉庫刪除也是一致的，刪除克隆倉庫文件夾下的本地文件后點擊push即可。

 

 

 而從遠程添加或刪除文件的話，若想改變本地的克隆數據庫，需要點擊Repository下的pull，這樣本地的倉庫會刪除和添加文檔，直至與遠程倉庫相同。切記如果還是點擊push會改變遠程倉庫。