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

筆者剛接觸不久，把認為入門應該知道的東西稍微總結一下。以后可能還會有補充。本文寫于2015年6月4日，github可能有時效性。

使用git需要有一定的命令行基礎

?

1.github注冊

注冊很簡單，有郵箱就能注冊，要上傳項目文件需要登錄后點擊右上角的加號創建一個Repository。Repository個數應該是不限的。

?

2.Repository

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

?

3.git help

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

      git help
    

?

4.本地操作

創建完Repository后，可以下載github工具git。

windows系統，會提供一個圖形界面的登錄框，輸入郵箱和密碼登錄。

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

      git init
    

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

      git add .
    

?下面關聯git地址，這里建議使用ssh地址，筆者初學使用https地址總是報錯。將下面代碼的username和repositoryname改為自己的名稱

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

如果地址不小心寫錯了，使用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官網，可能有時效性)

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

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

      git init
    

使用ssh-keygen工具創建key，最后引號中需要填寫你的賬戶郵箱

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

等一會直到出現下列提示，需要輸入存儲key的路徑，直接回車可以存儲在默認路徑里(建議存儲在默認路徑)

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

如果key已存在的話會提示是否覆蓋，否則會出現以下兩個提示，出現這些提示直接回車就好。

      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]
      
    

下面會提示創建完成，會在/Users/you/.ssh目錄下生成兩個文件id_rsa和id_rsa.pub.

?

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

      
        ssh-agent
      
       -s
    

或者使用下面的命令

      eval $(
      
        ssh-agent
      
       -s)
    

如果可用的話會輸出agent pid，例如：

      Agent pid 
      
        59566
      
    

確認沒問題后，利用ssh-add命令添加

      
        ssh-add
      
       ~/.
      
        ssh
      
      /id_rsa
    

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

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

官方建議使用如下命令復制：

      clip < ~/.
      
        ssh
      
      /id_rsa.pub
    

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

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

打開后Ctrl+A復制所有。粘貼完成后點擊 add key，網站上的配置就算完成了。

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

      
        ssh
      
       -T git@github.com
    

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

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

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

其他系統不同之處以后補充

github入門需知