Git notes

參考書籍 reference

• 為自己學 git
• pro git 2

什麼是 git

• git 是開源的分散式版本控制系統
• github 為共同協作的一個平台(商業網站)，本體為 git server

安裝 git install git

• macOS

$ brew install git

• linux

$ sudo yum install git

git 設定檔 configuration

• 全域設定，使用 --global

$ git config --global user.name <user-name>
$ git config --global user.email <user-email>

• 針對特定資料夾(專案)設定，使用 --local

$ git config --local user.name <user-name>
$ git config --local user.email <user-email>

• 查看設定檔

$ git config --list

$ cat .git/config

• 設定 git cli 別名(alias)

$ git config --global alias.s status
$ git config --global alias.c commit
$ git config --global alias.l "log --oneline --graph --all"

新增 git repositories

• 現有專案初始化(init)

$ git init

• clone 遠端專案

$ git clone <url>
$ git clone https://github.com/tidyverse/dplyr.git

• 取消 git

$ rm -r .git

Recording Changes to the Repository

• git 檔案分為四種狀態
  • Untracked
  • Unmodified
  • Modified
  • Staged
• 查看 git repositories 狀態(status)

$ git status

• 輸出簡短資訊，加上-s參數

$ git status -s

將檔案從工作目錄加入 git staged

• 單一檔案

$ git add <file>

• 所有檔案

$ git add --all

• 加入空資料夾 先在資料夾中新增任ㄧ空檔案，ex:> .gitkeep

$ touch <empty_dir>/.gitkeep
$ git add <empty_dir>/.gitkeep

• 只選擇部分區塊

$ git add -p <file>

將暫存區 staged 內容提交到 git 倉庫

$ git commit -m "<your-commit-message>"

• commit 空的內容

$ git commit --allow-empty -m "<commit-message>"

• add 結合 commit

$ git commit -a -m "<commit-message>"

• GPG-sign commits

$ git commit -S [<keyid>] -m "<commit-message>"

刪除檔案

• 直接刪除

$ rm <file>
$ git add <deleted file> # 將刪除檔案加入暫存區

• 使用 git 刪除，會直接將刪除檔案加入暫存區(staged)

$ git rm <file> 

• 保留檔案，但將檔案從暫存區移除

$ git rm --cached <file>

變更檔名

$ git mv <file_from> <file_to>

檢視 commit 紀錄

$ git log

• 檢視特定檔案

$ git log <file>

• 檢視特定檔案每次 commit 做過的修改

$ git log -p <file>
$ git show <file/commit>

• 檢視每次 commit 新刪修的數量

$ git log --stat

• 以特定的格式呈現

$ git log --pretty=format
$ git log --color --graph --pretty=format:'%C(bold white)%h%Creset -%C(bold green)%d%Creset %s %C(bold green)(%cr)%Creset %C(bold blue)<%an>%Creset' --abbrev-commit --date=relative

• 以圖形方式呈現

$ git log --oneline --graph
$ git log --pretty=oneline --abbrev-commit --graph

• 尋找特定日期範圍

$ git log --since=<datetime> --until=<datetime> 
$ git log --after=<datetime> --before=<datetime>

• 尋找 commit 檔案內容中關鍵字

$ git log -S <word>

• 尋找 commit 訊息中關鍵字

$ git log --grep=<word>

• 尋找某人的commit

$ git log --auther=<name>
$ git log --committer=<name>

• reference logs

$ git reflog

修改 commit 紀錄

• 修改最近一次 commit 訊息

$ git commit --amend -m "<commit-message>"

• 修改 commit 歷史訊息(commit 合併/拆解/重做/刪除/調整順序)

git rebase -i <commit-to>

• 追加檔案到最近一次 commit，不修改 commit 訊息

$ git commit -a --amend --no-edit

• 追加檔案到最近一次 commit，修改 commit 訊息

$ git commit -a --amend -m "<new-commit-message>"

忽略檔案規則 ignore specified files

• 專案目錄中建立.gitignore檔案，將要忽略檔案名稱寫入.gitignore檔案中

$ touch .gitignore

• 無視.gitignore規則

$ git add -f <file>

• .gitignore的規則只對建立後的檔案有效，如要套用規則，需使用git rm --cached將檔案逐一移出追蹤，或使用git clean -fx全部清除在規則內被忽略的檔案

取消修改被修改檔案

將暫存區的檔案拉回(覆蓋)工作目錄的檔案

$ git checkout -- <file>

git checkout 後面接分支為切換分支

重做 commit

• 直接選取 commit

$ git reset <commit>

• 使用相對方式 回到距離 HEAD 前3個 commit 的位置

$ git reset HEAD~3 <commit>
$ git reset HEAD^^^ <commit>

^n 為第個順位的 parent commit

• reset 主要有3種模式：--mixed、--soft和--hard，--mixed為預設模式

• 另一種重做方式，較 reset 保險，因會新增一個 commit 來取消不要的 commit

$ git revert --no-edit <commit>

• reset, revert, rebase 比較

查看 git 物件 object

• 查看類型

$ git cat-file -t <object hash>

• 查看內容

$ git cat-file -p <object hash>

分支 branch 操作

分支為指向某個 commit 的指標

• 查看分支狀態

$ git branch

• 建立分支

$ git branch <branch-name>

• 刪除分支

$ git branch -d <branch-name>
$ git branch -D <branch-name> #force delete

• 變更分支名稱

$ git branch -m <branch-name>

• 切換分支

$ git checkout <branch-name>

• 切換分支時如無分支就建立該分支

$ git checkout -b <branch-name>

• 合併分支

$ git merge <branch> #使用 merge
$ git rebase <branch> #使用 rebase

• 不使用快轉模式合併分支

$ git merge --no-ff <branch>

• 取消 rebase

$ git reset ORIG_HEAD --hard

• 撿其他分支的 commit 進行合併，加上--no-commit參數後，可先撿過來但不合併

$ git cherry-pick <commit>

標籤 tag

• 查看標籤

$ git tag [<tag-name>]

• 新增輕量標籤 (lightweight tag)

$ git tag <tag-name>

• 新增附註標籤 (annotated tag)

$ git tag -a -m <msg> <tag-name>

• 指定 commit 新增標籤

$ git tag <tag-name> <commit>

• 刪除標籤

$ git tag -d <tag-name>

儲存目前工作狀態

• 列出已儲存 stash 清單

$ git stash list

• 將目前工作狀態加入 stash

$ git stash [push]

• 從 stash 清單中取出 stash，並移除清單中的 stash，相當於 apply + drop

$ git stash pop stash@{<stash index>}

• 從 stash 清單中取出 stash，但保留清單中的 stash

$ git stash apply stash@{<stash index>}

• 刪除 stash

$ git stash drop stash@{<stash index>}

將檔案從 git 真正移除

1. 移除特定檔案

$ git filter-branch -f --tree-filter "rm -f <file-name>"

2. 刪除備份點

$ rm .git/refs/original/refs/heads/master

3. 讓reflog過期(預設為30天過期)

$ git reflog expire --all --expire=now

4. 立即啟動 git 資源回收機制

$ git gc --prune=now

遠端操作 remote

• 設定遠端 server 節點

$ git remote add <name> <url>
$ git reomte add origin <url> #預設節點名稱為`origin`

• 檢視 remote 設定的更多資訊

$ git remote -v
$ git remote show origin

• 重新命名遠端節點

$ git remote rename <old-name> <new-name>

• 刪除遠端節點

$ git remote remove <name>

• 刪除遠端分支(將本地空的分支推到)

$ git push origin :<branch-name>

• 將資料推上遠端倉庫(remote repository)

$ git push
$ git push <remote-name> <branch-name>
$ git push <remote-name> <local-branch-name>:<remote-branch-name>

• 將資料推上遠端倉庫，並設定上游(upstream)分支節點

$ git push -u origin master

把master分支的內容，推向origin這個位置 將origin遠端倉庫上master分支指到最新的進度，如遠端倉庫沒有 master 分支，就建立和master同名的分支

• 從 remote repository 下載資料(fetch)

$ git fetch [<remote>]

• 從 remote repository 下載資料並更新本地的進度(same as fetch + merge)

$ git pull

• 使用 rebase 方式下載更新

$ git pull --rebase

• 從伺服器取得 repository

$ git clone <repository>

• 從伺服器取得 repository並存成不同目錄名稱

$ git clone <repository> <name>

使用 github 製作靜態網頁

• 將資料堆到名為gh-pages分支

製作用 email 傳送的更新檔 patch

• 製作最新 k 次 commit 的更新檔

$ git format-patch -k -o <dir-name>

• 使用更新檔

$ git am <dir-name>