Learn Git in 30 days—— 第 24 天：使用 GitHub 遠端倉庫 - 入門篇

寫的非常好的一個Git系列文章，強烈推薦

原文鏈接：https://github.com/doggy8088/Learn-Git-in-30-days/tree/master/zh-cn

GitHub 是目前全世界最多人採用的 Git 線上管理平臺，他包含了完整的 Git 遠端倉庫實作，還有完整的議題追蹤機制與報表，更有成千上萬的開源碼項目都在 GitHub 進行 Git 版本控制。即便在我們公司，也有許多項目採用 GitHub 當成我們主要的 Git 平臺。本篇文章主要帶大家上手 GitHub 最基本的使用方式。

我們先來說明在 GitHub 建立項目的兩種不同的方式。

在 GitHub 建立一個「沒有版本」的空白 Git 倉庫

先登入 GitHub，再進入 GitHub 首頁： https://github.com

點選右上角你的使用者名稱進入個人首頁：

切換到 Repositories 頁籤：

再點選右邊綠色的 New 按鈕，以建立一個你自己的 GitHub 項目 (包含 Git 遠端倉庫)：

如果你要建立一個「沒有版本」的空白 Git 倉庫，最重要的就是最下方的 Initialize this repository with a README 不要勾選，還有 Add .gitignore 與 Add a licenes 都保留預設的 None 選項：

最後按下 Create repository 即可建立完成，當你建立起一個「沒有版本」的空白 Git 倉庫之後，畫面最下方也提到了幾個讓你上傳本地 Git 倉庫的指令教學，照着打就可以把本地倉庫的變更上傳到 GitHub 的遠端倉庫中。

在 GitHub 建立一個「有初始化版本」的 Git 倉庫

建立一個「有初始化版本」的空白 Git 倉庫，其實就是在 GitHub 建立項目時，勾選了一些初始化的文件，在建立的過程 GitHub 會依據你所挑選的選項，先幫你建立好一個初始化的 Git 版本：

建立完成後，在 GitHub 上顯示的內容會不太一樣，因爲你已經有一個 commit 版本在上面了：

將本地倉庫的變更上傳到遠端倉庫的方法

我有在【第 03 天：建立倉庫】這篇文章中提到如何取得從 GitHub 建立的遠端倉庫 (remote repository)，不過若要將本地變更送上 GitHub 則有好幾種不同的方式，其中包括：

在 GitHub 建立一個「沒有版本」的空白 Git 倉庫，然後通過 git clone 取得遠端倉庫，再建立版本後上傳
在 GitHub 建立一個「沒有版本」的空白 Git 倉庫，然後直接將現有的本地 Git 倉庫上傳到指定的 GitHub 項目
在 GitHub 建立一個「有初始化版本」的 Git 倉庫，然後通過 git clone 取得遠端倉庫，再建立版本後上傳
在 GitHub 建立一個「有初始化版本」的 Git 倉庫，然後直接將現有的本地 Git 倉庫上傳到指定的 GitHub 項目

以上就是我們首次使用 GitHub 時，最常見的四種上傳方式。嚴格說起來，上述四種上傳方式，應該只有兩種而已，也就是：

通過 git clone 取得遠端倉庫，再建立版本後上傳
直接將現有的本地 Git 倉庫上傳到指定的 GitHub 項目

爲什麼我想拆成四個來講呢？主要有兩個原因：

【通過 git clone 取得遠端倉庫，再建立版本後上傳】的這種方式，因爲「沒有版本」的空白 Git 倉庫，連預設的 master 分支都沒有，所以用預設的指令無法上傳到遠端倉庫。所以在指令操作上會有兩種用法。
【直接將現有的本地 Git 倉庫上傳到指定的 GitHub 項目】的這種方式，因爲通常一個 Git 倉庫只會有一個「初始 commit 物件」，如果你在本地倉庫已經建立了幾個版本，代表在你的本地倉庫中已經有了自己的「初始 commit 物件」，這將會與 GitHub 建立的「有初始化版本」的 Git 倉庫相互衝突，所以上傳的指令也會有些不同。

以下我們先來說明【通過 git clone 取得遠端倉庫，再建立版本後上傳】這個方法。

通過 `git clone` 取得遠端倉庫，再建立版本後上傳

這個方法最簡單，因爲你還沒有本地倉庫的存在，什至連工作目錄都還沒有，所以我們直接利用 git clone 即可把項目下載。然而，在使用 GitHub 的時候，最簡單的方法就是利用 GitHub for Windows 工具。你只要點擊 Clone in Desktop 按鈕，即可自動啓動 GitHub for Windows 工具幫你下載 Git 項目：

「沒有版本」的空白 Git 倉庫
「有初始化版本」的 Git 倉庫

你也可以直接複製 GitHub 提供的 URL 網址，然後利用 git clone 指令下載，例如：

如果你用 git clone https://github.com/doggy8088/sandbox-empty.git 複製一個「沒有版本」的空白 Git 倉庫，將會得到一個 warning: You appear to have cloned an empty repository. 警告消息，不過這不影響你上傳本地的變更。

如果你用 git clone https://github.com/doggy8088/sandbox-initialized.git 複製一個「有初始化版本」的 Git 倉庫，將會直接從 GitHub 下載擁有完整變更歷史的「遠端倉庫」，所以你會看到有下載物件數量、壓縮、解壓縮等信息。

我們以 sandbox-empty 這個項目爲例，由於這是一個「沒有版本」的空白 Git 倉庫，在 GitHub 上的遠端倉庫是完全空的，連預設的 master 分支都沒有，所以在下達 git push 指令時必須加上 -u 參數，才能成功地把本地倉庫上傳到 GitHub 上的遠端倉庫，其指令是 git push -u origin master

我們再以 sandbox-initialized 這個項目爲例，由於這是一個「有初始化版本」的 Git 倉庫，在 GitHub 上的遠端倉庫已經有一個版本，同時也建立好預設的 master 分支，所以在下達 git push 指令時可以不用加上 -u 參數，就成功地把本地倉庫上傳到 GitHub 上的遠端倉庫，其指令是 git push origin master

當你第二次建立版本時，直接執行 git push 就會自動上傳成功：

不過，當你執行簡單版本的 git push 會出現一段提示，告訴你要設定 push.default 這個選項，因爲這種簡寫的 git push 方法，Git 的預設行爲將會在 Git 2.0 之後發生改變，建議你通過設定 push.default 選項的方式明確指定 push 的方法。詳細說明請參見 git help config 的說明文件，搜尋 push.default 即可找到相關說明。我建議各位設定成 simple，以利跟日後的 Git 指令列工具的預設值相同，指令如下：

git config --global push.default simple

設定好之後，下次執行 git push 就不會再出現提示消息了：

之後的操作，在我們這兩個練習用的工作目錄都完全一樣。

直接將現有的本地 Git 倉庫上傳到指定的 GitHub 項目

接下來我們再來說明【直接將現有的本地 Git 倉庫上傳到指定的 GitHub 項目】這個方法。但由於練習用的 GitHub 項目已經被上傳一些物件，所以請各位重新再建立兩個新項目，分別是一個「沒有版本」的空白 Git 倉庫，與另一個「有初始化版本」的 Git 倉庫。

一個「沒有版本」的 Git 倉庫，項目名稱：sandbox-empty2 一個「有初始化版本」的空白 Git 倉庫，項目名稱：sandbox-initialized2

接着我們建立兩個本地倉庫與工作目錄，指令如下：

mkdir sandbox-empty2
cd sandbox-empty2

git init

echo a > a.txt
git add .
git commit -m "Initial commit"

cd ..
mkdir sandbox-initialized2
cd sandbox-initialized2

git init

echo a > a.txt
git add .
git commit -m "Initial commit"

我們先以 sandbox-empty2 項目爲例，由於我們本地倉庫跟 GitHub 上的遠端倉庫完全沒有關聯，所以必須告訴 Git 遠端倉庫在哪。這時我們可以輸入 git remote add origin https://github.com/doggy8088/sandbox-empty2.git 建立一個名爲 origin 的參照名稱，並指向 https://github.com/doggy8088/sandbox-empty2.git 位址，也就是我們在 GitHub 上的遠端倉庫位址。接着就跟我們先前講解的步驟一模一樣，如下圖示：