github是一個(gè)有海量開源代碼庫的網(wǎng)站，同時(shí)也是一個(gè)軟件開發(fā)管理軟件，作為軟件來說它集成了git這個(gè)分布式的版本控制系統(tǒng)，可以上傳、下載和管理自己的代碼。

筆者剛接觸不久，把認(rèn)為入門應(yīng)該知道的東西稍微總結(jié)一下。以后可能還會(huì)有補(bǔ)充。本文寫于2015年6月4日，github可能有時(shí)效性。

使用git需要有一定的命令行基礎(chǔ)

?

1.github注冊(cè)

注冊(cè)很簡單，有郵箱就能注冊(cè)，要上傳項(xiàng)目文件需要登錄后點(diǎn)擊右上角的加號(hào)創(chuàng)建一個(gè)Repository。Repository個(gè)數(shù)應(yīng)該是不限的。

?

2.Repository

Repository分為public和private兩種，其他人可以通過網(wǎng)頁訪問你的空間下載public的代碼。public是免費(fèi)的，private收費(fèi)。單個(gè)Repository最大容量為1G，應(yīng)該沒有文件數(shù)量限制，單個(gè)文件的大小不能超過100M。

?

3.git help

git都在命令終端界面下操作，如果有不記得的命令可以使用help指令獲取幫助

      git help
    

?

4.本地操作

創(chuàng)建完Repository后，可以下載github工具git。

windows系統(tǒng)，會(huì)提供一個(gè)圖形界面的登錄框，輸入郵箱和密碼登錄。

可以在本地打開git shell工具，使用cd命令定位到需要上傳代碼的目錄，然后使用git init對(duì)當(dāng)前目錄初始化git

      git init
    

?然后使用git add [要添加的文件列表]添加文件，使用git add .代表添加當(dāng)前目錄所有文件

      git add .
    

?下面關(guān)聯(lián)git地址，這里建議使用ssh地址，筆者初學(xué)使用https地址總是報(bào)錯(cuò)。將下面代碼的username和repositoryname改為自己的名稱

      git remote add origin git@github.com:
      
        username
      
      /
      
        repositoryname
      
      .git
    

如果地址不小心寫錯(cuò)了，使用set-url命令修改

      git remote set-url origin git@github.com:
      
        username
      
      /
      
        repositoryname
      
      .git
    

每次提交要先使用commit命令，commit后面可以跟上本次提交的說明

      git commit -m 
      
        "
      
      
        commit test
      
      
        "
      
    

最后使用push命令提交

      git push -u origin master
    

如果其他地方修改了代碼可以使用pull命令下載

      git pull -u origin master
    

其中 -u origin master中指用戶，origin master為初始用戶。

?

5.ssh操作

(該步驟大多摘自GitHub官網(wǎng)，可能有時(shí)效性)

如果在一個(gè)新目錄下想要pull或者clone github的代碼的話，需要設(shè)置ssh key

首先cd到需要下載代碼的目錄然后初始化

      git init
    

使用ssh-keygen工具創(chuàng)建key，最后引號(hào)中需要填寫你的賬戶郵箱

      
        ssh-keygen
      
       -t rsa -b 
      
        4096
      
       -C 
      
        "
      
      
        your_email@example.com
      
      
        "
      
    

等一會(huì)直到出現(xiàn)下列提示，需要輸入存儲(chǔ)key的路徑，直接回車可以存儲(chǔ)在默認(rèn)路徑里(建議存儲(chǔ)在默認(rèn)路徑)

      Enter 
      
        file
      
      
        in
      
      
        which
      
       to save the key (/Users/you/.
      
        ssh
      
      /id_rsa): [Press enter]
    

如果key已存在的話會(huì)提示是否覆蓋，否則會(huì)出現(xiàn)以下兩個(gè)提示，出現(xiàn)這些提示直接回車就好。

      Enter 
      
        file
      
      
        in
      
      
        which
      
       to save the key (/Users/you/.
      
        ssh
      
      /id_rsa): [Press enter]
    

      Enter passphrase (empty 
      
        for
      
      
         no passphrase): [Type a passphrase]

Enter same passphrase again: [Type passphrase again]
      
    

下面會(huì)提示創(chuàng)建完成，會(huì)在/Users/you/.ssh目錄下生成兩個(gè)文件id_rsa和id_rsa.pub.

?

然后將key加入ssh-agent.加入前可以先用命令確認(rèn)ssh-agent是否可用。

      
        ssh-agent
      
       -s
    

或者使用下面的命令

      eval $(
      
        ssh-agent
      
       -s)
    

如果可用的話會(huì)輸出agent pid，例如：

      Agent pid 
      
        59566
      
    

確認(rèn)沒問題后，利用ssh-add命令添加

      
        ssh-add
      
       ~/.
      
        ssh
      
      /id_rsa
    

添加完成后需要將ssh-key添加到github網(wǎng)站賬戶中去，網(wǎng)頁上登錄后，點(diǎn)擊最右上的按鈕，然后點(diǎn)擊setting（以后位置可能會(huì)有變化，反正記得找setting）,然后在左側(cè)列表中點(diǎn)擊ssh keys，點(diǎn)擊右邊 add ssh-key

其中title隨便寫，key需要上面生成id_rsa.pub的所有內(nèi)容（不要改任何格式）。

官方建議使用如下命令復(fù)制：

      clip < ~/.
      
        ssh
      
      /id_rsa.pub
    

不過我在windows下報(bào)錯(cuò)了，不支持'<' 符號(hào)，我用的是記事本打開的方法，記事本后面的路徑需要是windows的路徑方式

      notepad C:\Users\you\.
      
        ssh
      
      \id_rsa.pub
    

打開后Ctrl+A復(fù)制所有。粘貼完成后點(diǎn)擊 add key，網(wǎng)站上的配置就算完成了。

可以本地使用測試命令測試連接

      
        ssh
      
       -T git@github.com
    

可能會(huì)有yes/no的輸入提示，記得輸入yes。以下提示為成功

      Hi username! You
      
        '
      
      
        ve successfully authenticated, but GitHub does not 
      
      provide shell access.
    

完成這些步驟后本地就可以使用clone和pull下載代碼了(pull前記得 add origin)。

其他系統(tǒng)不同之處以后補(bǔ)充

github入門需知