如何使用Git上傳專案程式碼到GitHub

這是我第一次應用Git的歷程筆記，以下僅供Git初學者參考使用。

GitHub是一個基於Git的程式碼託管平台，付費使用者可以建私人倉庫，我們一般的免費使用者只能使用公共倉庫，也就是程式碼要公開。這對於一般人來說公共倉庫就已經足夠了。

1.註冊賬戶以及建立倉庫

要想使用GitHub第一步當然是註冊GitHub賬號了。之後就可以建立倉庫了（免費使用者只能建公共倉庫），Create a New Repository，填好名稱後Create，之後會出現一些倉庫的設定資訊，這也是一個git的簡單教學。

2.安裝用戶端tortoiseGit

GitHub是伺服器端，要想在自己電腦上使用git我們還需要一個git用戶端，我這裡選用TortoiseGit，他給我們提供了圖形介面的操作。在安裝之前首先需要安裝git，下載地址http://msysgit.github.com/，TortoiseGit下載地址：http://code.google.com/p/tortoisegit/

裝完後右鍵滑鼠會多出一些選項來，在本地倉庫裡右鍵選擇Git Init Here，會多出來一個.git資料夾，這就表示本地git建立成功。右鍵Git Bash進入git命令列，為了把原生的倉庫傳到github，還需要設定ssh key。

3.設定Git

（1） 首先在本地建立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。

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

$ ssh -T git@github.com

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

（3）接下來我們要做的就是把本地倉庫傳到github上去，在此之前還需要設定username和email，因為github每次commit都會記錄他們。

$ git config --global user.name "your name"

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

（4）進入要上傳的倉庫，右鍵git bash，新增遠端地址：

$ git remote add origin git@github.com:yourName/yourRepo.git

後面的yourName和yourRepo表示你再github的使用者名稱和剛才新建的倉庫，加完之後進入.git，開啟config，這裡會多出一個remote “origin”內容，這就是剛才新增的遠端地址，也可以直接修改config來設定遠端地址。

4.提交、上傳

（1）接下來在本地倉庫裡新增一些檔案，比如README，

$ git add README

$ git add README$ git commit -m "first commit"

（2）上傳到github：

$ git push origin master

git push命令會將本地倉庫推播到遠端伺服器。

git pull命令則相反。

修改完程式碼後，使用git status可以檢視檔案的差別，使用git add 新增要commit的檔案，也可以用git add -i來智慧新增檔案。之後git commit提交本次修改，git push上傳到github。

5.gitignore檔案

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

bin

.suo

obj

bin和obj是編譯目錄，裡面都不是原始碼，忽略；suo檔案是vs2010的組態檔，不需要。這樣你在git status的時候就只會看到原始碼檔案了，就可以放心的git add -A了。

GitHub 教學系列文章： 

通過GitHub建立個人技術部落格圖文詳解  http://www.linuxidc.com/Linux/2015-02/114121.htm

GitHub 使用教學圖文詳解  http://www.linuxidc.com/Linux/2014-09/106230.htm 

Git 標籤管理詳解 http://www.linuxidc.com/Linux/2014-09/106231.htm 

Git 分支管理詳解 http://www.linuxidc.com/Linux/2014-09/106232.htm 

Git 遠端倉庫詳解 http://www.linuxidc.com/Linux/2014-09/106233.htm 

Git 本地倉庫（Repository）詳解 http://www.linuxidc.com/Linux/2014-09/106234.htm 

Git 伺服器搭建與用戶端安裝  http://www.linuxidc.com/Linux/2014-05/101830.htm 

Git 概述 http://www.linuxidc.com/Linux/2014-05/101829.htm 

分享實用的GitHub 使用教學 http://www.linuxidc.com/Linux/2014-04/100556.htm