這篇文章是初學的時候撰寫的，其中一些觀念並不正確，步驟也可能因為更新或觀念問題而不適用或者多餘，此篇文章僅為留做紀錄

學習目標

因為 Git 指令一直出問題，今天就來搞清楚 Git 跟 GitHub 的各種問題吧！

學習內容

Git 跟 GitHub 是什麼

Git Wiki 則說 Git 是一種分散式版本控制軟體。

詳細的說明可以參考 Git Documentation，有中文版，不過只有前幾個主題有翻譯。

GitHub Wiki上說，GitHub 是一個透過 Git 進行版本控制的軟體原始碼代管服務，簡單來說就是可以放各種 Code 的地方，但其實也可以放一些文件跟圖片等，好像沒有空間限制，只是有單一檔案大小 1GB 的軟性限制。

Git 觀念

這裡我們來先解釋一下 Git版本控制的觀念，我覺得 寫點科普 寫的這兩篇寫得非常平易近人而且完整，推薦給大家！

• GIT新手入門教學 – PART 1
• GIT新手入門教學 – PART 2

我的理解是譬如有一份作業需要大家一起作，大家先把原始的作業文件 (origin) 放在小組長那邊 (remote)，然後各自 copy 一份回家 (local) 寫自己要做的部分，然後拿回去給小組長，由小組長決定誰的作業寫得好，可以成為新一代的原始作業文件 (master)；或某人提交的作業寫得不完整，但寫過地那部分很好，就跟原始作業合併 (merge) 成一份新一代的原始作業文件。大家也可以 copy 別人寫的作業回去修改 (pull)，反正最後由小組長決定哪個版本的作業寫得最好，就可以成為新一代的原始作業文件這樣。

而大家 copy 回家寫的作業也有三個階段，假如我在電腦上打作業，分成三個資料夾，一個是 Working Directory、一個是 Staging Area、一個是 Repository。

第一個資料夾就是放 copy 回家的作業，然後我可能亂打了一些、新增修改了一些，但交出去很丟臉的部分；第二個資料夾就是放某些我覺得可以的部分作業，先暫時存起來；最後一個資料夾就是放我確定要提交的作業版本。

所以我寫作業的流程就是這樣：

1. 先 copy 一份 (pull) 原始作業文件 (origin) 回家 (local)
2. 在 Working Directory 資料夾寫作業，找各種資料，新增刪減等等
3. 將比較滿意的部分暫存 (add) 到 Staging Area 資料夾
4. 當 Staging Area 資料夾有比較完整的作業版本後，再儲存 (commit) 到 Repository 資料夾中
5. 最後將 Repository 資料夾中要繳交的作業交出去 (push) 給小組長 (remote)

建立 GitHub 帳號

接下來說明實際操作流程。

建議大家先到 GitHub 建立自己的帳號，基本功能都是免費的，只有當你要發展私人專案，想要將 repositories 設定為 private 的時候會要收費的樣子。(更正：GitHub 已於 2019/1/7 開放免費無限量 private repo，可參見 這篇聲明)

GitHub 帳號申請流程跟一般申請免費帳號一樣，就到首頁按下綠色的 Sign up for GitHub 按鈕之後，一路照指示填上資料跟選擇選項就可以了。然後 GitHub 會寄一封認證 email，請點 email 裡面的 Verify email address 那個連結來確認你的 email address。

接下來先作 Git 的環境設定，這樣之後就可以都在 Git Bash 操作各種指令，不用在 Git Bash 跟 PowerShell 視窗換來換去。如果是 Mac 用戶，則都可以用 MacOS 隨附的「終端機 Terminal」軟體，或安裝下載相同功能的 iTerm2 來操作 Git 指令。

Git 環境設定

先說明我一般使用的是 Windows 10，兼有一台 Macbook Pro。但我是超級初心者，所以 Linux 我完全不會，抱歉。

先安裝 Git，這步驟很簡單。Windows 就到 Git官網 下載就好，而且一鍵安裝，這邊不需要多講；若是 MacOS 用戶，請利用 Homebrew 安裝 Git，安裝 Homebrew 跟 Git 的操作過程可以參考我的 這篇文章，然後可以直接跳到下一個主題：設定 Git 識別資料。

然後應該會在 Windows 按鈕（狀態列左邊 Windows 圖示的那顆）裡面的程式集多一個 Git 的資料夾，裡面有三個程式：Git Bash、Git CMD 跟 Git GUI。最常用的大概是 Git Bash，原則上都在這裡下各種 Git 指令；Git CMD 我不知道拿來幹嘛；Git GUI 是圖形介面，但設計的不太好用。

如果大家沒有要學太多 Git 指令，其實可以直接下載 GitHub Desktop 或 Sourcetree，圖形化介面真的太好用，也不用記一堆 Git 指令。但今天沒有要教大家怎麼用 GitHub Desktop 跟 Sourcetree，或其實大家看完後面 Git 概念教學就大概會懂使用流程。

設定 Git 識別資料

安裝完 Git 之後，首先應該設定使用者名稱跟 email，應該要跟你之前申請 GitHub 帳號時的 username 及 email 相同。

以下步驟使用到的指令，基本上在 Windows 跟 MacOS 上是一樣的，只有一些地方會有所不懂，我會特別說明。

請打開 Git Bash，可能在桌面就有，或者開始按鈕裡的程式集 Git 資料夾裡面有，MacOS 請打開終端機，然後依序輸入以下兩行 Git 指令：

git config --global user.name "GitHub username"  
git config --global user.email "GitHub email"

接著你可以輸入以下指令來檢查資訊是否有輸入正確。

cat ~/.gitconfig

建立 SSH Key 並增加到 GitHub

SSH Key 就像一個鑰匙，每一台電腦、筆電都會生成一個獨一無二的 SSH Key，然後我們上自己的 GitHub 去登記這個鑰匙，這樣以後我們用電腦或筆電上傳東西到 GitHub 時，電腦或筆電就可以用這個鑰匙，以及前面設定的 Git 識別資料去開啟我們的 GitHub 帳號並把東西上傳上去。

就跟我們要去銀行存錢，要提供身分證 (Git 識別資料) 跟密碼 (SSH Key) 給銀行一樣。

要生成一個 SSH Key，一樣在之前打開的 Git Bash 或終端機輸入以下指令：

ssh-keygen -t rsa -C "GitHub帳號的 email"

會出現以下這行，設定儲存 SSH Key 的位置，使用預設的就好，所以直接按 Enter。

Enter file in which to save the key (/Users/使用者名稱/.ssh/id_rsa): [Press enter]

如果你以前有設定過 SSH Key，它會出現這行 /Users/you/.ssh/id_rsa already exists. Overwrite (y/n)?，建議直接打 yes 或 y 來重新操作以確保正確。接著會出現以下這行來問你是不是要為 SSH Key 設定一個密碼，要就輸入，並且會需要再輸入一次作確認，不要就直接 Enter。

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

然後他就會顯示一大段文字，表示 SSH Key 產生成功，接著我們把 SSH Key 加到 ssh-agent 來免除每次要連接登入 GitHub 都還要再輸入一次 SSH Key 的密碼。請先輸入以下指令：

eval $(ssh-agent -s)

接著會出現這行 Agent pid 8492，數字每個人都不一樣，這沒關係。接著輸入以下這行，可能會需要重新輸入一次 SSH Key 的密碼：

ssh-add ~/.ssh/id_rsa

如果出現 Identity added 這行字就表示成功了。

再來需要把 SSH Key 加入到自己的 GitHub 帳號。

首先在同樣的 Git Bash 畫面輸入以下這行，將 SSH Key 複製到剪貼簿裡面，就類似平常按 Ctrl+C 那樣複製。

clip < ~/.ssh/id_rsa.pub

如果是 Mac 使用者，請到 /使用者名稱/.ssh/ 這個資料夾，若找不到請調整隱藏檔的設定，然後用文字編輯打開 id_rsa.pub 這個檔案，講整個檔案內容複製起來。

然後用瀏覽器進入到你自己的 GitHub 帳號，點最右上角的三角形，選 Settings，然後選左邊列表的 SSH and GPG keys，點綠色的 New SSH key，然後在 Key 下面的欄位直接 Ctrl+V 或 command+V 把 SSH Key 貼上，在 Title 欄位輸入你之後能辨識這個 SSH Key 是代表哪一台電腦或筆電的名稱，最後點綠色的 Add SSH key 按鈕就添加完成啦！

然後作個小測試，在同樣的 Git Bash 或終端機輸入 ssh -T git@github.com，可能會看到類似以下的一段文字：

The authenticity of host 'github.com (207.97.227.239)' can't be established.  
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.  
Are you sure you want to continue connecting (yes/no)?

fingerprint 後面那一串長長的字每個人都不一樣，這也沒關係。輸入 yes 後應該會跳出以下訊息：

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

這段文字中的 <username> 是你 GitHub 設定的 username，這樣就代表成功啦！

建立 Project 並上傳到 GitHub

接下來利用建立一個新專案來介紹一些 Git 的基本指令。

首先先到桌面或隨便一個資料夾，建立一個 test 資料夾，然後在資料夾裡面隨便新增一個文字檔案，公堂之上假設一下 假設就叫 first-post.md (md 檔案是 Markdown 語言的檔案，內容可以被 GitHub 直接讀取並且辨識)，接著請在 test 資料夾內的空白處點右鍵，選 Git Bash Here，就會打開 Git Bash，並預設路徑就是 test 資料夾。

如果是 MacOS 使用者，也請建立一個資料夾，並同樣新增一個 first-post.md 文字檔案，請對該資料夾按一下右鍵或 control 鍵出現選單，再按著 option 鍵，會出現 拷貝「資料夾名稱」作為路徑名稱 的選項，選擇之後就會複製資料夾路徑。然後開啟終端機輸入 cd，然後空一格貼上剛才複製的路徑，以移動操作位置到該資料夾，很重要，請一定要做。

cd <資料夾路徑>

接著就要開始操作 Git 指令，如果覺得我講的不清楚，可以回去看寫點科普那兩篇文章的觀念跟操作。

這邊還是記錄一下我的作法。請大家，不論是 Windows 或 MacOS 使用者，都輸入以下命令：

git init

init 就是 initialize，這代表將這個資料夾變成一個 Repository，Git 就會開始記錄這個 Repo 裡面的所有改動跟版本。然後以下指令會新增全部 test 資料夾裡面的檔案到 staging 的狀態。

git add .

staging 好了之後，再用下面這個指令來 commit 到本機的 Repo，這些 commit 到 Repo 的東西才能被 push 到 GitHub上。

git commit -m "說明操作了什麼的一段文字"

這過程中隨時都可以用 git status 指令來查看你處於哪個階段。

最後要 push 到 GitHub 之前，請先到 GitHub 上建立一個名稱為 test 的 Repository，建立好之後，請點中間 SSH 那個按鈕，後面會生成該 Repo 的 SSH url，把那個網址複製下來。若建立 Repo 的時候有勾 README 選項，則按右邊綠色 Clone or download 按鈕，點藍色 Use SSH 連結切換到 Clone with SSH，再複製 url。

最後一樣到剛才的 Git Bash 或終端機裡面輸入以下命令，我們要將 commit push 到 GitHub 上。過程中可能會要輸入 SSH 密碼。

git remote add origin git@github.com:GitHub使用者名稱/test.git  
git push origin master

第一句是要為這個專案加上 GitHub 上面 Repo 的位置，後面要 push，Git 才知道要 push 到哪裡。第二句話就是把已經 commit 的版本 push 到 GitHub 對應 Repo 的 master 分支上。master 也就是主要版本。

這樣就完成建立一個新 Project 並上傳到 GitHub 啦！

push 修改過的 Project 到 GitHub

最後，如果之後要修改剛建立的那個 Project 資料夾裡的任何內容，想要再把變更 push 到 GitHub 上，請在 test 資料夾打開 Git Bash，或終端機照前面說明移動位置到該資料夾下，輸入以下指令：

git add .  
git commit -m "說明文字"  
git push origin master

就很簡單的搞定啦！

至於 branch 那種東西，等我搞懂再來新增吧。今天先這樣~~

Last modified on 2017-09-14