前言

現在 Git 儼然已成為必備技能，你真的懂 Git 嗎?

Git 的發明原本是用來管理 Linux Kernel 的，這樣子的分散式版本控管程式是如何滿足存在於世界各地廣大的 Linux 開發者的，它的優勢在哪，為何逐漸熱門起來了呢？

Git 是一種易學難精的工具

80/20 法則

20% 的 git 指令就足以應付平日 80% 的工作了

- 高見龍

※ 所以本簡報單純僅供本次 WorkShop 使用，如需轉載請自行研究相關授權問題。

WorkShop 須知：

• 已經你的開發環境安裝並可以執行 git。
• 先辦好 GitHub。
• 教學會已 command line 為主 GUI Tool 只單純用來看 Brnach 用。

Git 操作流程

- 來源：掌握 Git & Github 程式時光機

工作目錄、加入索引、提交版本流程介紹

git add . // 加入所有檔案索引
git status // 檢查狀態
git commit -m '修改紀錄' //提交更新
git log // 查詢紀錄

1. 當檔案要加進 Local Respository 前要先使用 git add 檔案 新增進索引。
2. 這邊可以使用 git status 來觀察索引的狀態。
3. 在來使用 git commit -m '修改紀錄' 來加進 Local Respository 內。
4. 如果需要查看先前的 commit 可以使用 git log 來做紀錄的查詢。

gitignore - 忽略檔案

使用 .gitignore 來忽略不想 commit 的檔案

test.html # 
*.html  # 忽略全部的 HTML 檔案
css/ # 忽略 css 資料夾

gitignore大全 - 這邊有官方提供的各種例子

工作狀態還原技巧分享

# 取消索引
git reset HEAD // 全部檔案取消索引
git reset HEAD 檔案名稱 // 單一檔案取消索引

# 還原檔案
git checkout 檔案名稱 // 恢復單一檔案到最新的 commit
git reset --hard

GitHub 介紹

Git !== GitHub

世界上最大的工程師交友平台

Github 就是遠端的 Respository

Github 免費的帳號只能開 public 的 Respository，如果需要 private 的 Respository，則需要收錢，這邊介紹了一個免費可以開私人數據庫的網站 Bitbucket，但依然有其限制，

git push - 推送數據庫到 Github

1. 在 Github 上 New respository 後使用 git clone URL 將遠端 Respository 複製到本地端
2. 新增檔案後一樣使用 git add 和 git commit 將此版本加入本地的 Respository
3. 接下來要將本地端的 Respository 更新到遠端的 Respository，這邊使用 git push 這指令，這樣 github 上的 Respository 就會出現你剛剛新增檔案的那個版本了

從 Github 找出實用插件流程

使用 github 來找函示庫跟插件的好處在於，可以清楚知道他是否還有在維護，也可以從星星數來看該專案的熱門程度

Github Pages - 存放網頁空間流程

GitHub 可以直接顯示靜態網頁，在 Settings > GitHub Pages 選擇 Source 為網頁所在的分支，這樣就 OK 了

範例：我的個人頁面

Git 分支 (branch) 簡介

- 範例分支圖網址

WTF?

先給先觀念：

• branch 很便宜。
• 在多人開發環境下通常不會直接使用 master 分支。
• 在多人開發時，溝通很重要。
• 多人協作專案進行時，很多時候遇到的問題都不是工程問題。
• 溝通的成本很高！！

衍生提醒：
1.變數命名的重要性 2.Coding Style 的重要性 …

HEAD - 瞭解目前所在位置

HEAD：目前所在位置的指標

git branch // 瀏覽目前分支
git checkout // commit前4碼
// ex: 要查看的 commit 紀錄 id 為 ca6c374ac6d4b4afd19ec885a07b3f75a44b0ec6
// 只要下 git checkout ca6c 就好
git checkout master // 切換回 master 

git branch - 分支創立

git branch 分支名 // 建新的分支
git checkout 分支名 // 切換到該分支

git checkout -b 分支名 // 建立新的分支後直接切換到該分支

git merge - fast-forward

git merge 別的bramch // 將別的 branch 合併到當前分支

講一個環境比較單純的，在 master 未做任何 commit 時將 branch 合併回來，使用一些 git GUI 來看會是一條線。

Mac or Linux 自動合併細節提醒

如果你是 Mac 或 Linux 開發者，在下一篇會需要使用到編輯器來寫 merge 的更新訊息，

在未指定編輯器的情況下，會出現 vim 的編輯器 此時已會預設帶好 commit 的內容，只要依序輸入以下文字：

:wq!

就可離開

git merge - 自動合併篇

當分支切出去後 master 有 commit，這時如果要 merge 分支時，在沒衝突的情況下會自動合併，使用 command line 執行的情況下，會跳出 merge 時的 commit 資訊，此時如上面提到的使用 :wq 離開後就 OK 了，如果需要更改 commit 資訊也可以直接在這邊修改。

git merge - 解決衝突篇

在合併時如果修改到一樣的行數，就會跳出 conflicts ，這時點開衝突的檔案會看到

<<<<<<< HEAD
衝突程式(目前所在分支)
=======
衝突程式(分支上的)
>>>>>>> YourBranch

修改完後儲存，新增索引後在 commit 就完成合併了(最好 commit 時註明這是 merge)

git tag - 標籤

標籤的功能可以讓你在眾多的 commit 當中知道重要的 commit，也能夠直接 checkout 過去。

git tag // 查詢標籤(只看到有哪些標籤)
git tag -n // 查詢詳細標籤(還能看到標籤備註)
git tag -d 標籤名稱 // 刪除標籤
git tag 標籤名稱 // 新增輕量標籤
git tag -am "備註內容" 標籤名稱 // 新增標示標籤

git checkout 標籤名稱 // 切換到標籤的 commit

git stash - 暫存檔案

開發過程中如果突然需要先做其他事情，但還沒 commit 不能切換分支，所以可以先把暫存暫存下來，等到其他事情做完後，切回來此分支後就可以再拿出來繼續做。

git stash // 暫時儲存當前目錄
git stash list // 瀏覽 git stash 列表
git stash pop // 還原暫存
git shash drop // 清除最新暫存
git stash clear // 清除全部暫存

Git、Github 團隊協作篇

git remote - 遠端數據庫

遠端數據庫預設名稱是 origin，可以使用 git remote 來查看，所以當你直接使用 git push 時他會不知道你要推到哪一個，所以平常在 push 時我都會使用，git push origin master。

前面教學之所以使用 git push 能夠成功，是因為預設會追蹤 master，所以 git push 時他會使用預設的 master，但當你在分支時就無法直接這樣推。

# 如何推送分支到遠端數據庫
git remote // 查詢遠端數據庫
git remote rename 原名稱 修改名稱 // 修改遠端數據庫名稱
git push origin master
         [預設遠端主機名稱] [分支名稱]

git pull - 下載遠端數據庫

• 要將遠端數據庫的資料更新到目錄時，使用 git pull。
• 要將遠端數據庫的資料更新到當前數據庫時，使用 git fetch。

※ 兩者的差異會在後續最進一步說明

git pull - 衝突篇

DEEMO

小型團隊分支協作篇

實作上會在 feature 做完你負責的部分後再 merge 回 develop 後，當這部分進度都完成後，才會將 develop merge 回 master。


※ 溝通很重要！！

git pull = git fetch + git merge

當練習完 pull 時，可以知道他就是將遠端的分支將你的本地分支進行合併 merge 的動作，但有時候你不希望 pull 下來導致自己的數據庫太亂又擔心有衝突時，可以先使用下面這個指令。

git fetch origin(遠端數據庫) branch1(遠端分支)

此時你的分支會多一個 FETCH_HEAD 的分支，這個就是遠端數據庫的分支，可以等到你看過沒問題後，再合併 FETCH_HEAD 也 ok。

GitHub - 參與一個專案

如果你想要參與一個你沒有推送權限的專案，你可以「fork」一份。這代表說 GitHub 會複製一份這個專案的副本給你，並且你對這副本有全部的權限。這副本會存在於你的帳號下，你可以對它進行推送。
(來源：GitHub - 參與一個專案)

一般情況下就是照著下面的程序運作的：

1. 從 master 建立一個主題分支。

2. 加入一些變更來改善這個專案。

3. 把這個分支推送到你的 GitHub 專案。

4. 在 GitHub 上建立一個 Pull Request。

5. 討論，並在需要的時候加入新的變更。

6. 專案擁有者視情況決定要把這個 Pull Request 合併進原始專案，或是關閉它。

你可能會遇到的問題：

我 Fork 後，如果那個專案更新了，那我該如何更新我自己的專案。

A：設定 upstream

git remote add upstream https://github.com/otheruser/repo.git

再看一次 remote

git remote -v
origin https://github.com/user/repo.git (fetch)
origin https://github.com/user/repo.git (push)
upstream https://github.com/otheruser/repo.git (fetch)
upstream https://github.com/otheruser/repo.git (push)

更新 upstream

git fetch upstream
git fetch upstream feature/test // 更新特定分支

當你改完 code 後，就可以 push 回 "你的" 遠端數據庫。

這時點選在 GitHub 上的 Pull Request 按鈕(記得推回去的分支要選好)。

最後等作者 review 後覺得 OK 了，就可以把你的 PR Merge 回那個專案了。

延伸教學資源

• 連猴子都能懂得 Git 入門指南
• 保哥 30 天 Git 教學
• Git 官方繁體教學

GitHub 相關補充

• GitHub 上的 issues 通常用來回報一些問題，當開完 fix 分支修完 BUG 後，在 commit 實在訊息打上 issues 代號(ex: #1234)，這 commit 就會記錄在該 issue 裡。
• 當想參與專案時，流程通常都是先 Fork 回自己的 GitHub，當時作完成後 push 回自己的 GitHub Respository，再發PR(Pull Requests)回原始專案。

Git 指令相關補充

本次 WorkShop 教了些基礎的 Git 指令，但 Git 還有更多的功能可以使用，這便舉個小例子

git cherry-pick commit編號

Q & A

感謝您的參與！