1. 程式人生 > >Github上傳專案步驟和常見問題

Github上傳專案步驟和常見問題

最近大愛Web程式設計,於是尋找各種程式碼中,然後就發現了GitHub這個網站,如果你知道Google Code,那麼你就知道這個GitHub是做什麼的了。不過GitHub主要是用作基於Git的分散式版本管理系統的庫,可以儲存和管理自己的程式碼,而且主要用作程式碼的合作開發。不過對於我來說,Git控制系統還比較難以掌握,或者開發小系統還不太用得著,因此我把GitHub當作分享和展示程式碼的網站。

wKioL1TwMp-Qm9tUAAC1JCMX6SM296.jpg

註冊GitHub後你就會有0.3G的免費空間,不過只能建立公開專案,這也滿足程式碼分享的目的,我最喜歡的倒是它的程式碼展示方式,可以直接瀏覽你的程式碼,程式碼是經過高亮、新增行號處理過的,十分漂亮,體驗一流,比如這個

Webpy託管的地方。而作為想要了解你程式碼的人,可以選擇直接線上瀏覽自己感興趣的,也可以直接下載壓縮包,或者直接使用Git clone到本地。

因為GitHub是基於Git版本控制系統,所以你上傳修改程式碼什麼的,都需要使用Git工具。我這裡主要是用來分享和展示程式碼,所以不想在版本控制方面做過多的闡述,下面就簡單講解一下怎麼在GitHub上新建一個專案,還有把自己的程式碼傳上去。下面的前提是你已經註冊了GitHub和下載安裝了Git——Git下載Windows版本下載

上傳分享程式碼

1.GitHub上建立專案

登入GitHub後,你可以在右邊靠中那裡找到一個按鈕“New Repository”

,點選過後,填入專案名稱、說明和網址過後就可以建立了,然後會出現一個提示頁面,記下類似[email protected]:XXX/XXX.git的地址,這個就是你這個專案的地址了。

2.配置Git以及上傳程式碼

安裝Git成功後,如果是Windows下,選擇Git Bash,在命令列中完成一切,可能開始有點麻煩,不過就那幾條命令列,用幾次就記住啦。首先初始設定Git

1 git config --global user.name "Your Real Name"2 git config --global user.email [email protected]

然後開始進行最麻煩的一步了,你需要上傳檔案到GitHub

Git系統上,得需要一個SSH密匙來認證,下面就開始生成金鑰和提交金鑰。開啟Git Bash,建立SSH key:

1 ssh-keygen -C '[email protected]' -t rsa

然後要你輸入SSH密匙的存放位置,可以不管,直接回車使用預設路徑。再輸入你想要的密碼,SSH key就生成了。現在你需要將這個Key提交到GitHub,首先開啟Key儲存的位置,裡面會有三個檔案,找到id_rsa.pub,用文字編輯器開啟,複製裡面的全部字元。到GitHub,在右上方工具欄裡找到Account Settings。在這個頁面上有一個SSH Public Keys標籤,選擇Add another public keyTitle可以隨便填一個,Key就貼上剛才的字元,提交。

完成這些工作後,就可以上傳自己的程式碼了。找到自己要分享上傳的程式碼資料夾,右擊選擇Git Bash,或者在Git Bash中進入這個資料夾。建立一個倉庫:

1 git init

選擇要新增進倉庫的檔案:

1 git add .

一般如果你想分享這個資料夾裡的所有程式碼,就在 add後面加“.”,上面的例子就是這樣,如果傳指定的,只需要把“.”改為檔名即可,現在只是選擇了要加入倉庫的檔案,下面才是新增進入倉庫:

1 git commit -m 'Test'

-m後面跟一個引數,表示說明,將程式碼提交到GitHub後,將會在程式碼檔案資訊上顯示這個說明,如下圖示記的地方。

搞了這麼久,現在才開始把本地倉庫上傳到GitHub了,下面兩行命令搞定問題:

首先需要pull下程式碼,才能push上傳成功

git pull origin master

繼續下面的操作

git pull origin master

3 git push -u origin master

這個[email protected]:XXX/XXX.git就是上面建立專案是生成的地址。現在開啟你的專案網址,你就可以發現你的程式碼已經展示出來了。如果你要更新程式碼的話,就重複上面的吧。

如果提交了敏感資訊,比如程式碼中設定的自己的密碼什麼的忘刪除就上傳上去了怎麼辦?重新修改過後上傳依然有歷史記錄,而使用Git刪除歷史記錄貌似很麻煩,於是就採用刪除專案吧,刪除了再重新上傳。刪除專案需要在GitHub網站上右上方找到admin按鈕,進去後右邊最下面有個刪除的按鈕,這樣就可以刪除了。

二、 Git 常用命令1) 遠端倉庫相關命令

檢出倉庫:        $ git clone git://github.com/jquery/jquery.git

檢視遠端倉庫:$ git remote -v

新增遠端倉庫:$ git remote add [name] [url]

刪除遠端倉庫:$ git remote rm [name]

修改遠端倉庫:$ git remote set-url --push [name] [newUrl]

拉取遠端倉庫:$ git pull [remoteName] [localBranchName]

推送遠端倉庫:$ git push [remoteName] [localBranchName]

*如果想把本地的某個分支test提交到遠端倉庫,並作為遠端倉庫的master分支,或者作為另外一個名叫test的分支,如下:

$git push origin test:master         // 提交本地test分支作為遠端的master分支

$git push origin test:test              // 提交本地test分支作為遠端的test分支

2)分支(branch)操作相關命令

檢視本地分支:$ git branch

檢視遠端分支:$ git branch -r

建立本地分支:$ git branch [name] ----注意新分支建立後不會自動切換為當前分支

切換分支:$ git checkout [name]

建立新分支並立即切換到新分支:$ git checkout -b [name]

刪除分支:$ git branch -d [name] ---- -d選項只能刪除已經參與了合併的分支,對於未有合併的分支是無法刪除的。如果想強制刪除一個分支,可以使用-D選項

合併分支:$ git merge [name] ----將名稱為[name]的分支與當前分支合併

建立遠端分支(本地分支push到遠端):$ git push origin [name]

刪除遠端分支:$ git push origin :heads/[name] 或 $ gitpush origin :[name] 

*建立空的分支:(執行命令之前記得先提交你當前分支的修改,否則會被強制刪乾淨沒得後悔)

$git symbolic-ref HEAD refs/heads/[name]

$rm .git/index

$git clean -fdx

3)版本(tag)操作相關命令

檢視版本:$ git tag

建立版本:$ git tag [name]

刪除版本:$ git tag -d [name]

檢視遠端版本:$ git tag -r

建立遠端版本(本地版本push到遠端):$ git push origin [name]

刪除遠端版本:$ git push origin :refs/tags/[name]

合併遠端倉庫的tag到本地:$ git pull origin --tags

上傳本地tag到遠端倉庫:$ git push origin --tags

建立帶註釋的tag:$ git tag -a [name] -m 'yourMessage'

4) 子模組(submodule)相關操作命令

新增子模組:$ git submodule add [url] [path]

如:$git submodule add git://github.com/soberh/ui-libs.git src/main/webapp/ui-libs

初始化子模組:$ git submodule init  ----只在首次檢出倉庫時執行一次就行

更新子模組:$ git submodule update ----每次更新或切換分支後都需要執行一下

刪除子模組:(分4步走哦)

1) $ git rm --cached [path]

2) 編輯“.gitmodules”檔案,將子模組的相關配置節點刪除掉

3) 編輯“ .git/config”檔案,將子模組的相關配置節點刪除掉

4) 手動刪除子模組殘留的目錄

5)忽略一些檔案、資料夾不提交

在倉庫根目錄下建立名稱為“.gitignore”的檔案,寫入不需要的資料夾名或檔案,每個元素佔一行即可,如

target

bin

*.db

三、 Git 命令詳解

現在我們有了本地和遠端的版本庫,讓我們來試著用用Git的基本命令:

git pull從其他的版本庫(既可以是遠端的也可以是本地的)將程式碼更新到本地,例如:'git pull origin master'就是將origin這個版本庫的程式碼更新到本地的master主枝,該功能類似於SVNupdate

git add是將當前更改或者新增的檔案加入到Git的索引中,加入到Git的索引中就表示記入了版本歷史中,這也是提交之前所需要執行的一步,例如'git add app/model/user.rb'就會增加app/model/user.rb檔案到Git的索引中,該功能類似於SVNadd

git rm從當前的工作空間中和索引中刪除檔案,例如'git rm app/model/user.rb',該功能類似於SVNrmdel

git commit提交當前工作空間的修改內容,類似於SVNcommit命令,例如'git commit -m story #3, add user model',提交的時候必須用-m來輸入一條提交資訊,該功能類似於SVNcommit

git push將本地commit的程式碼更新到遠端版本庫中,例如'git push origin'就會將本地的程式碼更新到名為orgin的遠端版本庫中

git log檢視歷史日誌,該功能類似於SVNlog

git revert還原一個版本的修改,必須提供一個具體的Git版本號,例如'git revert bbaf6fb5060b4875b18ff9ff637ce118256d6f20'Git的版本號都是生成的一個雜湊值

上面的命令幾乎都是每個版本控制工具所公有的,下面就開始嘗試一下Git獨有的一些命令:

git branch對分支的增、刪、查等操作,例如'git branch new_branch'會從當前的工作版本建立一個叫做new_branch的新分支,'git branch -D new_branch'就會強制刪除叫做new_branch的分支,'git branch'就會列出本地所有的分支

git checkoutGitcheckout有兩個作用,其一是在不同的branch之間進行切換,例如'git checkout new_branch'就會切換到new_branch的分支上去;另一個功能是還原始碼的作用,例如'git checkout app/model/user.rb'就會將user.rb檔案從上一個已提交的版本中更新回來,未提交的內容全部會回滾

git rebase用下面兩幅圖解釋會比較清楚一些,rebase命令執行後,實際上是將分支點從C移到了G,這樣分支也就具有了從CG的功能

wKioL1TwMsvQMbHrAAGxq1rxdMQ678.jpg

git reset將當前的工作目錄完全回滾到指定的版本號,假設如下圖,我們有A-G五次提交的版本,其中C的版本號是 bbaf6fb5060b4875b18ff9ff637ce118256d6f20(git log可以得到),我們執行了'git reset bbaf6fb5060b4875b18ff9ff637ce118256d6f20'那麼結果就只剩下了A-C三個提交的版本

wKioL1TwMtixHDrIAAF9X2KXl7w968.jpg

git stash將當前未提交的工作存入Git工作棧中,時機成熟的時候再應用回來,這裡暫時提一下這個命令的用法,後面在技巧篇會重點講解

git config利用這個命令可以新增、更改Git的各種設定,例如'git config branch.master.remote origin'就將master的遠端版本庫設定為別名叫做origin版本庫,後面在技巧篇會利用這個命令個性化設定你的Git,為你打造獨一無二的 Git

git tag可以將某個具體的版本打上一個標籤,這樣你就不需要記憶複雜的版本號雜湊值了,例如你可以使用'git tag revert_version bbaf6fb5060b4875b18ff9ff637ce118256d6f20'來標記這個被你還原的版本,那麼以後你想檢視該版本時,就可以使用 revert_version標籤名,而不是雜湊值了

Git 之所以能夠提供方便的本地分支等特性,是與它的檔案儲存機制有關的。Git儲存版本控制資訊時使用它自己定義的一套檔案系統儲存機制,在程式碼根目錄下有一個.git資料夾,會有如下這樣的目錄結構:

 wKiom1TwMdiCh7HXAACKoSUyBwY883.jpg

有幾個比較重要的檔案和目錄需要解釋一下:HEAD檔案存放根節點的資訊,其實目錄結構就表示一個樹型結構,Git採用這種樹形結構來儲存版本資訊,那麼HEAD就表示根;refs目錄儲存了你在當前版本控制目錄下的各種不同引用(引用指的是你本地和遠端所用到的各個樹分支的資訊),它有headsremotesstashtags四個子目錄,分別儲存對不同的根、遠端版本庫、Git棧和標籤的四種引用,你可以通過命令'git show-ref'更清晰地檢視引用資訊;logs目錄根據不同的引用儲存了日誌資訊。因此,Git只需要程式碼根目錄下的這一個.git目錄就可以記錄完整的版本控制資訊,而不是像SVN那樣根目錄和子目錄下都有.svn目錄。那麼下面就來看一下GitSVN的區別吧

一些可能遇到的問題解決:

如果輸入$ git remote add origin [email protected]:djqiang(github帳號名)/gitdemo(專案名).git
提示出錯資訊:fatal: remote origin already exists.
解決辦法如下:
1、先輸入$ git remote rm origin
2、再輸入$ git remote add origin [email protected]:djqiang/gitdemo.git 就不會報錯了!
3、如果輸入$ git remote rm origin 還是報錯的話,error: Could not remove config section ‘remote.origin’. 我們需要修改gitconfig檔案的內容
4、找到你的github的安裝路徑,我的是C:\Users\ASUS\AppData\Local\GitHub\PortableGit_ca477551eeb4aea0e4ae9fcd3358bd96720bb5c8\etc
5、找到一個名為gitconfig的檔案,開啟它把裡面的[remote "origin"]那一行刪掉就好了!

如果輸入$ ssh -T [email protected]
出現錯誤提示:Permission denied (publickey).因為新生成的key不能加入ssh就會導致連線不上github。
解決辦法如下:
1、先輸入$ ssh-agent,再輸入$ ssh-add ~/.ssh/id_key,這樣就可以了。
2、如果還是不行的話,輸入ssh-add ~/.ssh/id_key 命令後出現報錯Could not open a connection to your authentication agent.解
決方法是key用Git Gui的ssh工具生成,這樣生成的時候key就直接儲存在ssh中了,不需要再ssh-add命令加入了,其它的user,token等配置都用命令列來做。
3、最好檢查一下在你複製id_rsa.pub檔案的內容時有沒有產生多餘的空格或空行,有些編輯器會幫你新增這些的。

如果輸入$ git push origin master
提示出錯資訊:error:failed to push som refs to …….
解決辦法如下:
1、先輸入$ git pull origin master //先把遠端伺服器github上面的檔案拉下來
2、再輸入$ git push origin master
3、如果出現報錯 fatal: Couldn’t find remote ref master或者fatal: ‘origin’ does not appear to be a git repository以及fatal: Could not read from remote repository.
4、則需要重新輸入$ git remote add [email protected]:djqiang/gitdemo.git
使用git在本地建立一個專案的過程
$ makdir ~/hello-world    //建立一個專案hello-world
$ cd ~/hello-world       //開啟這個專案
$ git init             //初始化
$ touch README
$ git add README        //更新README檔案
$ git commit -m ‘first commit’     //提交更新,並註釋資訊“first commit”
$ git remote add origin [email protected]:defnngj/hello-world.git     //連線遠端github專案
$ git push -u origin master     //將本地專案更新到github專案上去
error: RPC failed; result=52, HTTP code = 0fatal: The remote end hung up unexpectedly

應該是pull 內容更新太多,需要設定postBuffer更大些,具體看下面的連結

git config --global http.postBuffer 524288000