GitHub 簡明入門級教程

寫在前面的話：

閱讀本文以前請確保已經裝好了git，而且已有github帳號。
本文僅爲入門級教程，沒有詳細的git命令說明，使用時還需查閱相關資料~

提示

安裝了git以後別忘記配置用戶名和郵箱哦，使用如下命令：

• 配置用戶名：

git config --global user.name "youname"

• 配置郵箱：

git config --global  user.email "youremail@email.com"

最後能夠經過 git config -l 命令查看已配置的用戶名和郵箱信息。

登錄github帳號後，進行如下操做：

1.建立遠程倉庫：

登陸github帳號後，進入以下界面：

點擊new repository開始建立倉庫

填寫好倉庫的名稱，設置權限(通常都爲public，這樣才能開源嘛~)
建議勾選最後一項，點擊下面的Create repository按鈕，這樣github上的遠程倉庫就建立好了。

注意：建立好遠程倉庫後，須要將其URL(HTTPS/SSH)保存下來，由於後面要用到~

2.生成SSH key

ssh key 提供了一種與github通訊的方式，能夠在不輸入密碼的狀況下，將github作爲本身的remote服務器，從而進行版本控制。

步驟：

• 檢查ssh是否存在
• 生成新的ssh key
• 將生成的ssh key添加到github中

明確了步驟以後，咱們來一步步進行操做吧~
首先：使用如下命令來查看是否有.ssh文件夾。如有，則能夠直接將ssh key添加到github中。

ls -al ~/.ssh

其次：若沒有該文件，則進行第二步，生成ssh key。輸入命令來生成ssh key

ssh-keygen -t rsa -C "youemail@email.com"

此時去用戶根目錄下查看，會有.ssh的文件夾。

該文件夾下有兩個文件：

id_rsa： 私鑰（不建議告訴別人哦~）
id_rsa.pub： 公鑰

最後：用編輯器打開id_rsa.pub文件，複製內容，在github的setting中，找到SSH and GPG keys目錄，將複製的內容添加到SSH keys中就ok啦~

3.將本地代碼push到github

cd到你的項目文件夾，使用git init命令，能夠使當前文件夾變爲能夠經過git來管理的文件夾，舉例子以下：

如今咱們打開剛纔建立的文件夾：

能夠看到有一個隱藏的.git文件，這就說明該文件夾已經能夠使用git來管理啦~

ok~如今咱們能夠在testgit2文件夾下建立要提交的文件，能夠手動建立，也能夠使用命令建立。
這裏咱們快速的用命令簡單建立一下吧~

注意：

• git add [filename]：該命令是將文件添加到暫存區，暫存區的概念後面再解釋。
• git commit -m "[string]"：該命令是將暫存區的文件提交到分支上。參數 -m 後面跟的字符串，是對提交文件的註釋。

進行到這一步，咱們一共作了兩件事：

• 在github上建立remote repository。
• 在本地倉庫完成了本身的項目代碼。

上面的命令都是在本地進行操做，下面的操做纔會和遠程服務器打交道~
接下來終於要push代碼了，將你本地完成的項目代碼提交到github上~

因而你開心的在命令行使用了渴望已久的push命令~

git push origin master

結果~報錯了o(╥﹏╥)o

別慌~先簡單看一下錯誤：「請確保你有正確的權限並卻倉庫是否存在。」

爲何報錯呢？ 有下面兩個緣由：

• 本地倉庫和github倉庫沒有關聯（從新remote）
• 生成的ssh key不對

解決方案：

• 關聯本地倉庫和遠程倉庫，使用下面命令(yourusername：你的遠程倉庫地址)

還記得剛建立遠程倉庫時你保存過的URL嗎~~~要上場了

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

關聯好以後，再次使用git push origin master命令，會發現提示如下信息：

出現這個問題的緣由是，咱們github建立的倉庫中，有 README.md文件沒有拉到本地

提示：初次pull代碼到本地，須要先合併本地的項目和遠程github的項目。由於咱們遠程倉庫中的README.md文件本地沒有，如果直接git pull origin master會報錯：

因此pull以前加一句命令~

git pull origin master --allow-unrelated-histories

使用以上命令合併兩個項目以後，再次git pull origin master，會有Already up to date的提示~

如今去咱們本地倉庫中，能夠看到遠程倉庫中的README.md文件以及pull到本地了~
終於 到了最後一步，盡情的push你的代碼到遠程倉庫吧~

git pull origin master

如今去github的倉庫中就能夠看到咱們push的代碼了~(^o^)/~