GitHub簡單入門教程

鬼腳飛發表於2015-05-24

一、前言

GitHub 使用 git 分散式版本控制系統，可以託管各種git庫，並提供一個web介面對git庫進行管理。為一個專案貢獻程式碼非常簡單：首先點選專案站點的“fork”按鈕，然後將程式碼檢出到自己的程式碼庫中，修改之後，最後可以通過內建的“pull request”機制向專案負責人申請程式碼合併。

二、使用方法：

1、註冊GitHub賬號以及建立倉庫

登入gitHub官網註冊gitHub賬號，之後找到Create a New Repository建立倉庫（免費使用者只能建公共倉庫），之後會出現一些倉庫的配置資訊。

這裡寫圖片描述

2、安裝客戶端msysgit

github是服務端，要想在自己電腦上使用git我們還需要一個git客戶端，因為我用的windows系統，所以這裡需要用到msysgit，這個只是提供了git的核心功能，而且是基於命令列的。如果想要圖形介面的話只要在msysgit的基礎上安裝TortoiseGit即可。

裝完msysgit後右鍵滑鼠會多出一些選項來，在本地倉庫裡右鍵選擇Git Init Here（或者開啟Git Bash控制檯，然後輸入命令git init即可），之後我們會看到本地倉庫中多出來一個.git資料夾（一般是隱藏的，顯示隱藏檔案就能看到），這就表示本地git建立成功。右鍵Git Bash進入git命令列，為了把本地的倉庫傳到github，還需要配置ssh key。

3、配置Git

首先在本地建立ssh key：

ssh-keygen -t rsa -C "your_email@youremail.com"

後面的your_email@youremail.com需要改成自己的郵箱，之後會要求確認路徑和輸入密碼，我們這使用預設的一路回車（應該是三個回車）就行。成功的話會在使用者主目錄下生成.ssh資料夾，進去會看到生成了兩個檔案，一個公鑰（可以給別人看）、一個私鑰（自己保留）。

這裡寫圖片描述

之後開啟公鑰id_rsa.pub，複製裡面的內容（key）。回到github，進入Account Settings，左邊選擇SSH Keys，Add SSH Key,title隨便填，貼上key。

這裡寫圖片描述

為了驗證是否成功，在git bash下輸入：

$ ssh -T git@github.com

如果是第一次的會提示是否continue，輸入yes就會看到：You’ve successfully authenticated, but GitHub does not provide shell access 。這就表示已成功連上github。

這裡寫圖片描述

接下來我們要做的就是把本地的專案上傳到github上去，在此之前還需要設定username和email，因為github每次commit都會記錄他們。這個地方上一篇部落格中有介紹到。

$ git config --global user.name "your name"  
$ git config --global user.email "your_email@youremail.com"

三、如何將本地專案上傳到GitHub倉庫

在本地專案所在目錄按以下步驟操作

git init

git add README.md

git commit -m "first commit"

git remote add origin git@github.com:yourusername/yourprojectname.git

git push -u origin master

注意：

yourusername這個一般是你的使用者名稱，yourprojectname這個是你的專案名，返回到GitHub的web介面可以檢視到。

這裡寫圖片描述

有的時候可能到了第四步出現了以下問題

$ git remote add origin git@github.com:yourusername/yourprojectname.git
fatal: remote origin already exists.

解決辦法如下：

1、先輸入

$ git remote rm origin

2、再輸入

$ git remote add origin git@github.com:yourusername/yourprojectname.git

就不會報錯了！

3、再次用push命令進行推送：

$ git push -u origin master

最後再次回到GitHub的web介面重新整理一下，就能夠看到自己剛剛上傳的專案了。。。

四、後續：

1、關於.gitignore檔案

.gitignore顧名思義就是告訴git需要忽略的檔案，這是一個很重要並且很實用的檔案。一般我們寫完程式碼後會執行編譯、除錯等操作，這期間會產生很多中間檔案和可執行檔案，這些都不是程式碼檔案，是不需要git來管理的。我們在git status的時候會看到很多這樣的檔案，如果用git add -A來新增的話會把他們都加進去，而手動一個個新增的話也太麻煩了。這時我們就需要.gitignore了。例如java專案的.classpath檔案、.project檔案等等，我們並不需要git來管理，這時就可以忽略掉。

在本地專案的目錄的空白處右鍵開啟Git Bash，輸入touch .gitignore建立一個.gitignore檔案或者直接新建一個txt記事本重新命名為.gitignore（注意，沒有字尾名，直接就是.gitignore）。

#忽略java的屬性配置檔案

/.settings  ##忽略資料夾
.classpath  ##忽略檔案
.mymetadata
.project

之後執行一系列命令add——》commit——》push即可（因為是首次提交到伺服器，而伺服器上沒有什麼更新，所有沒有必要執行pull命令）。

git add .

git commit -m "add .girignore file"

git push origin master

2、建立開發分支

因為我們首次把本地的專案上傳到GitHub上面都是master主幹分支，但是實際去做開發的時候，一般不會選擇在master主幹分支上進行操作，通常會在主幹master分支的基礎上再開闢出一個分支（例如dev分支），然後在這個dev分支上進行修改，最後再合併到master主幹分支上去。那這個時候可以這樣操作：

進入到本地專案所在的目錄，本地倉庫中，右鍵調出Git Bash控制檯，

1、建立分支，並且切換分支