# Git 常用指令備忘： checkut / reset / stash

## checkout
用來移動 HEAD 指標的指向，並且變更工作目錄（ working tree files ）的內容。

checkout 只會修改 HEAD 指標的位置與工作目錄內容，而不會異動到 branch 指標、 commit 和暫存區(staging area)的內容。

- `git checkout <branch name>` 切換分支。將 HEAD 指向指定的 branch，即把工作目錄內容替換為 branch 中的最新檔案
- `git checkout <commit id>` 將 HEAD 指向特定 commit，並將工作目錄替換為該 commit 內容
- `git checkout <file name>` 將指定檔案回復為未修改，即暫存區內或是最後一次提交的版本
- `git checkout .` 將工作目錄整個回復為未修改，即暫存區內或是最後一次提交的版本
:::info
`git checkout <file name>`、`git checkout .` 會把工作目錄內未提交的修改都清除掉，使用上要三思！
:::

當我們將 HEAD 指向某個 commit，而不是 branch 時，如果我們再提交 commit 時，這些 commit 將不會被連在任何 branch 上，而是處在斷頭的狀態（ detached HEAD ）。
斷頭狀態下建立的 commit 會比較難在被指向，必需使用 `git checkout <commit id>` 才能找到他。

### 解決 commit 斷頭的方法：
為他建立一個新的 branch 指向他，再將這個 branch 合併到工作分支上：

// 建立指向斷頭的 commit 的新分支 temp，如果正在該 commit 上，<commit id> 可以省略
$ git branch temp <commit id>

// 先回到工作分支
$ git checkout develop

// 將 temp 合併回工作分支
$ git merge temp

// 將 temp 分支刪除
$ git branch -d temp

:::info
要尋找 commit id，可以使用 `git reflog` 列出一個月內下過的 git 指令紀錄。
:::

## reset
移動 branch、HEAD 指標，並替換暫存區、工作目錄的內容。

`git reset <commit id>` 將目前 branch 指標指向特定 commit，並將拆出來的檔案丟回工作目錄。

`git reset HEAD^` 將目前分支指標退到 HEAD 所指向的前一個 commit，並將 commit 拆出來的檔案丟回工作目錄。其中，`HEAD^` 代表的是往前一個 commit，也可以用 `HEAD~1`; `HEAD^^` 往前兩個 commit，也可用 `HEAD~2`

如果目前正在 master 分支上，`git reset HEAD^` 與 `git reset master^` 的效果是一樣的。

:::info
如果對剛做完的 reset 反悔了，可以用這個指令回到 reset 前的 commit。

$ git reset ORIG_HEAD

:::

reset 有三種模式：mixed、soft、hard，沒有加參數時預設就是 mixed mode。三個模式都會移動 branch 指標，但其中差異是：
- `--mixed` 將 commit 拆出來的檔案放在工作目錄
- `--soft` 將 commit 拆出來的檔案放在暫存區
- `--hard` 將 commit 拆出來的檔案丟掉

例：
`$git reset master^`
將 master 往前回到上一個 commit，並將 commit 拆出來的檔案丟到工作目錄

`$git reset master^ --soft`
將 master 往前回到上一個 commit，並將 commit 拆出來的檔案移至暫存區

`$git reset master^ --hard`
將 master 往前回到上一個 commit，並將工作目錄及暫存區的變更刪除。

:::info
口語上使用"拆" commit 較好理解，但實際上 commit 並沒有被拆掉，只是移動了 branch 指標，並將工作目錄或暫存區的檔案替換。
:::

#### `git reset HEAD <file name>`
將暫存區內的檔案移回工作目錄。如果沒有指定檔案，就是將整個暫存區退回工作目錄。

## stash 儲存檔案修改的快照
#### `git stash`
將目前修改過的被追蹤檔和暫存的變更的快照保存到一個 stack 中。使用 `git stash` 儲存變更後，working tree files 會回到未修改的狀態。

當我們開發到一半尚未 commit，但希望可以 checkout 到其他位置時，可以用 `git stash` 將未 commit 的修改先暫存起來，待之後 checkut 回來在回存之前的進度。

> 如果沒有變更的狀態下，使用 `git stash` 會出現 `No local changes to save`

:::info
要 stash untracked 的檔案，要加上參數 -u
:::

#### `git stash list`
列出 stash 中保存的快照

stash@{0}: WIP on develop-kris: c5fe7cc uBike 改版型 & 新增搜尋功能 / 天氣資訊日期顯示優化修改
stash@{1}: WIP on develop-kris: c5fe7cc uBike 改版型 & 新增搜尋功能 / 天氣資訊日期顯示優化修改
stash@{2}: WIP on develop: 6142006 [修改] 減少不必要的調整
(END)

#### `git stash apply <stash name>`
將 stash 回存到 working tree files。如果沒有指定 stash name，預設使用最新的。回存的 branch 沒有限定要跟儲存時是同一個，例如在 branch develop 下儲存的 stash，可以在 branch master 回存。

#### `git stash pop <stash name>`
套用 stash 並將它從 stash list 中移除。沒有指定 stash name，預設使用最新的。

#### `git stash drop <stash name>`
刪除某一筆 stash

---

## Get Branches that contain specific commit

$ git branch --contains <sha1-commit-hash>

- 沒有加上參數，僅會列出本地分支
- 加上 -r 僅列遠端分支
- 加上 -a 本地遠端皆列出