從 0 開始學習 GitHub 系列之【向 GitHub 提交代碼】

01-25

作者：stormzhang

來源：微信公眾號 stormzhang

更多精彩文章，關注專欄：學習編程 - 知乎專欄

之前的這篇文章「從0開始學習 GitHub 系列之「Git速成」」相信大家都已經對 Git 的基本操作熟悉了，但是這篇文章只介紹了對本地 Git 倉庫的基本操作，今天我就來介紹下如何跟遠程倉庫一起協作，教你們向 GitHub 上提交你們的第一行代碼！

1. SSH

你擁有了一個 GitHub 賬號之後，就可以自由的 clone 或者下載其他項目，也可以創建自己的項目，但是你沒法提交代碼。仔細想想也知道，肯定不可能隨意就能提交代碼的，如果隨意可以提交代碼，那麼 GitHub 上的項目豈不亂了套了，所以提交代碼之前一定是需要某種授權的，而 GitHub 上一般都是基於 SSH 授權的。

那麼什麼是 SSH 呢？

簡單點說，SSH是一種網路協議，用於計算機之間的加密登錄。目前是每一台 Linux 電腦的標準配置。而大多數 Git 伺服器都會選擇使用 SSH 公鑰來進行授權，所以想要在 GitHub 提交代碼的第一步就是要先添加 SSH key 配置。

2. 生成SSH key

Linux 與 Mac 都是默認安裝了 SSH ，而 Windows 系統安裝了 Git Bash 應該也是帶了 SSH 的。大家可以在終端（win下在 Git Bash 里）輸入 ssh 如果出現以下提示證明你本機已經安裝 SSH，否則請搜索自行安裝下。

緊接著輸入 ssh-keygen -t rsa ，什麼意思呢？就是指定 rsa 演算法生成密鑰，接著連續三個回車鍵（不需要輸入密碼），然後就會生成兩個文件 id_rsa 和 id_rsa.pub ，而 id_rsa 是密鑰，id_rsa.pub 就是公鑰。這兩文件默認分別在如下目錄里生成：

Linux/Mac 系統在 ~/.ssh 下，win系統在 /c/Documents and Settings/username/.ssh 下，都是隱藏文件，相信你們有辦法查看的。

接下來要做的是把 id_rsa.pub 的內容添加到 GitHub 上，這樣你本地的 id_rsa 密鑰跟 GitHub 上的 id_rsa.pub 公鑰進行配對，授權成功才可以提交代碼。

3. GitHub 上添加 SSH key

第一步先在 GitHub 上的設置頁面，點擊最左側 SSH and GPG keys ：

然後點擊右上角的 New SSH key 按鈕：

需要做的只是在 Key 那欄把 id_rsa.pub 公鑰文件里的內容複製粘貼進去就可以了（上述示例為了安全粘貼的公鑰是無效的），Title 那欄不需要填寫，點擊 Add SSH key 按鈕就ok了。

這裡提醒下，怎麼查看 id_rsa.pub 文件的內容？

Linux/Mac 用戶執行以下命令：

cd ~/.ssh

cat id_rsa.pub

Windows用戶，設置顯示隱藏文件，可以使用 EditPlus 或者 Sublime 打開複製就行了。

SSH key 添加成功之後，輸入 ssh -T git@github.com 進行測試，如果出現以下提示證明添加成功了。

4. Push & Pull

在提交代碼之前我們先要了解兩個命令，也是上次的文章沒有介紹的，因為這兩個命令需要跟遠程倉庫配合。

Push ：直譯過來就是「推」的意思，什麼意思呢？如果你本地代碼有更新了，那麼就需要把本地代碼推到遠程倉庫，這樣本地倉庫跟遠程倉庫就可以保持同步了。

代碼示例： git push origin master

意思就是把本地代碼推到遠程 master 分支。

Pull：直譯過來就是「拉」的意思，如果別人提交代碼到遠程倉庫，這個時候你需要把遠程倉庫的最新代碼拉下來，然後保證兩端代碼的同步。

代碼示例： git pull origin master

意思就是把遠程最新的代碼更新到本地。一般我們在 push 之前都會先 pull ，這樣不容易衝突。

5. 提交代碼

添加 SSH key 成功之後，我們就有許可權向 GitHub 上我們自己的項目提交代碼了，而提交代碼有兩種方法：

Clone自己的項目

我們以我在 GitHub 上創建的 test 項目為例，執行如下命令：

git clone git@github.com:stormzhang/test.git

這樣就把 test 項目 clone 到了本地，你可以把 clone 命令理解為高級點的複製，這個時候該項目本身就已經是一個git 倉庫了，不需要執行 git init 進行初始化，而且甚至都已經關聯好了遠程倉庫，我們只需要在這個 test 目錄下任意修改或者添加文件，然後進行 commit ，之後就可以執行：

git push origin master

進行代碼提交，這種是最簡單方便的一種方式。

至於怎麼獲取項目的倉庫地址呢？如下圖：

關聯本地已有項目

如果我們本地已經有一個完整的 git 倉庫，並且已經進行了很多次 commit ，這個時候第一種方法就不適合了。

假設我們本地有個 test2 的項目，我們需要的是在 GitHub 上建一個 test 的項目，然後把本地 test2 上的所有代碼 commit 記錄提交到 GitHub 上的 test 項目。

第一步就是在 GitHub 上建一個 test 項目，這個想必大家都會了，就不用多講了。

第二步把本地 test2 項目與 GitHub 上的 test 項目進行關聯，切換到 test2 目錄，執行如下命令：

git remote add origin git@github.com:stormzhang/test.git

什麼意思呢？就是添加一個遠程倉庫，他的地址是 git@github.com:stormzhang/test.git ，而 origin 是給這個項目的遠程倉庫起的名字，是的，名字你可以隨便取，只不過大家公認的只有一個遠程倉庫時名字就是 origin ，為什麼要給遠程倉庫取名字？因為我們可能一個項目有多個遠程倉庫？比如 GitHub 一個，比如公司一個，這樣的話提交到不同的遠程倉庫就需要指定不同的倉庫名字了。

查看我們當前項目有哪些遠程倉庫可以執行如下命令：

git remote -v

接下來，我們本地的倉庫就可以向遠程倉庫進行代碼提交了：

git push origin master

就是默認向 GitHub 上的 test 目錄提交了代碼，而這個代碼是在 master 分支。當然你可以提交到指定的分支，這個之後的文章再詳細講解。

對了，友情提醒，在提交代碼之前先要設置下自己的用戶名與郵箱，這些信息會出現在所有的 commit 記錄里，執行以下代碼就可以設置：

git config —global user.name "stormzhang"

git config —global user.email "stormzhang.dev@gmail.com"

6. 總結

通過本文的介紹，終於大家可以成功的向 GitHub 提交代碼了，但是相信大家還有很多疑問，比如關於分支的理解與使用，比如 git 的其他一些有用的配置，比如怎麼向一些開源項目貢獻代碼，發起 Pull Request 等，之後的系列文章會逐一進行介紹，敬請期待。