[Git] .git版本控制系統 – 指令速查表 (彙整教學)

以下為彙整其他Git資料加上自己持續再更新修改，如有問題或建議歡迎回覆！

Config - 環境設定

git config --global user.name "Nick"
git config --global user.email nick@example.com
git config --global color.ui true  //打開 Git 的 color 顏色設定，如 git status

因為初次未設定，從 git config --list 會找不到該參數名，所以列上

git config --global --unset user.name # 移除KEY

HTTPS記憶帳號密碼，執行後下次HTTPS登入資訊會被儲存：

git config credential.helper store

# 移除設定與已存帳密
git config --unset credential.helper

Remote - 遠端設定

# 列出remote repository info
git remote -v 
git remote show //僅列Repositories

# 新增Repository URL
git remote add origin git://new.url.here 
git remote add new-origin git://new.url.here //新增new-origin repository並指定URL

# 更改Repository URL
git remote set-url origin git://new.url.here 

# 新增Repository Push URL (manipulate push URLs)
git remote set-url --add --push origin git://backup.url.here

# 增加遠端 Repository 的 branch(origin -> project)
git remote add new-branch http://git.example.com.tw/project.git 

# 停用遠端Repository push & fetch
git remote set-url --push new-origin disabled

# 刪除Repository
git remote rm new-origin

Pull - 從遠端更新

git pull //預設為origin Master
git pull origin master

實際作用原理為先 git fetch 遠端的 branch，然後與本地端的 branch 做 merge，產生一個 merge commit 節點

所謂的”遠端”預設叫做origin，當你有多個不同遠端伺服器時，就會取不同名子了。

Push - 將 Commit 送出去

git push //預設為origin Master
git push origin master

實際的作用原理為將本地端的 master branch 與遠端的 master branch 作 fast-forward 合併。如果出現 [rejected] 錯誤的話，表示你必須先作 pull。

git push origin +HEAD
git push origin +HEAD:{brach}   // 適用於搭配reset刪除遠端commit

Git 新增檔案git add .

將資料先暫存到 staging area, add 之後再新增的資料, 於此次 commit 不會含在裡面.

git add filename
git add modify-file //修改過的檔案, 也要 add. (不然 commit 要加上 -a 的參數)
git add -u //只加修改過的檔案, 新增的檔案不加入.
git add -i //進入互動模式

Git 刪除檔案

git rm filename

Git 清除Cache

例如Git含有submodule欲刪除後，需要清空.git/index Cache以讓Main module追蹤原submodule目錄。

git rm --cached -r folder

Git 修改檔名、搬移目錄

git mv filename new-filename

Git status 看目前的狀態

git status

Git Commit

git commit
git commit -m 'commit message'
git commit -a -m 'commit -message' //將所有修改過得檔案都 commit, 但是 新增的檔案 還是得要先 add.
git commit -a -v //-v 可以看到檔案哪些內容有被更改, -a 把所有修改的檔案都 commit

// 無異動Commit (Commit message only)
git commit --allow-empty

// 修改、修正已提交Commit
git commit --amend
git commit --amend --date="Wed Feb 16 14:00 2017 +0800"
git commit --amend --date="now"

Git Branch

Git Branch 基本操作

git branch //列出目前有多少 branch
git branch new-branch //產生新的 branch (名稱: new-branch), 若沒有特別指定, 會由目前所在的 branch / master 直接複製一份.
git branch new-branch master //由 master 產生新的 branch(new-branch)
git branch new-branch v1 //由 tag(v1) 產生新的 branch(new-branch)

# 更改Local Branch名稱
git branch -m 
git branch -m  

# 刪除Local Branch
git branch -d new-branch
git branch -D new-branch //強制刪除 new-branch

# 強制刪除所有Local Branches除了當前branch by BASH 
git branch | grep -v \* | xargs git branch -D 
git branch --merged | grep -v \* | xargs git branch -D //僅刪Merged過的Branches

git checkout -b new-branch test //產生新的 branch, 並同時切換過去 new-branch
//與 remote repository 有關
git branch -r //列出所有 remote repository  branch
git branch -a //列出所有 branch

Git checkout 切換 branch

git checkout branch-name # 切換到 branch-name
git checkout master # 切換到 master
git checkout -b new-branch master # 從 master 建立新的 new-branch, 並同時切換過去 new-branch
git checkout -b newbranch # 由現在的環境為基礎, 建立新的 branch
git checkout -b newbranch origin # 於 origin 的基礎, 建立新的 branch
git checkout filename # 還原檔案到 Repository 狀態
git checkout HEAD . # 將所有檔案都 checkout 出來(最後一次 commit 的版本), 注意, 若有修改的檔案都會被還原到上一版. (git checkout -f 亦可)
git checkout xxxx . # 將所有檔案都 checkout 出來(xxxx commit 的版本, xxxx 是 commit 的編號前四碼), 注意, 若有修改的檔案都會被還原到上一版.
git checkout -- * # 恢復到上一次 Commit 的狀態(* 改成檔名, 就可以只恢復那個檔案)

Git remote branch 維護遠端分支檔案

# 更新所有 Remote branchs
git remote update

# 完整更新(追蹤已刪除--prune)所有 Remote branchs
git remote update -p 

# 列出所有 Remote branchs
git branch -r 

# 刪除Remote branch 
git push origin :branch
git push origin --delete branch //v1.7.0 support

抓取 / 切換 Repository 的 branch

git fetch origin

# 抓取 reps-branch, 並將此 branch 以相同名稱建立於 local 的 reps-branch
git checkout --track origin/reps-branch 

# 抓取 reps-branch, 並將此 branch 以自訂名稱建立於 local 的 reps-branch
git checkout --track -b reps-branch origin/reps-branch 

# 抓取 Pull Request 分支並切換至該分支
git fetch origin pull/{ID}/head:{BRANCH_NAME}
git checkout {BRANCH_NAME}

Checking out pull requests locally - Github Docs

Git track all remote branch 抓取所有遠端分支

# Bash - 將Remote Branches全名抓下來至Local(存在branch name問題不一致問題)
for remote in git branch -r ; do git branch --track $remote; done

# Bash - 完美指令(剔除HEAD以及更名為Local使用的Branch名稱)
for remote in git branch -r | grep -v /HEAD; do git checkout --track $remote ; done
// No Merged branches only 
for remote in git branch -r --no-merged | grep -v /HEAD; do git checkout --track $remote ; done
for remote in git branch -r --no-merged | grep -v /HEAD ; do git branch --track ${remote/"origin/"/""}; done //其實結果同上

Git diff

git diff master # 與 Master 有哪些資料不同
git diff --cached # 比較 staging area 跟本來的 Repository
git diff tag1 tag2 # tag1, 與 tag2 的 diff
git diff tag1:file1 tag2:file2 # tag1, 與 tag2 的 file1, file2 的 diff
git diff # 比較 目前位置 與 staging area
git diff --cached # 比較 staging area 與 Repository 差異
git diff HEAD # 比較目前位置 與 Repository 差別
git diff new-branch # 比較目前位置 與 branch(new-branch) 的差別
git diff --stat

Git Tag

git tag v1.0.0 //新增Tag至當前commit
git tag v1 ebff //新增Tag至ebff commit
git tag 中文 ebff //Tag也可以下中文, 任何文字都可以
git tag -d tagname //刪除 tag=tagname 
git push --delete origin tag //刪除遠端 tag=tagname 

git push --tags //推送所有Local Tags至remote
git fetch --prune --tags //抓取remote Tags
git ls-remote --tags origin //列出remote Tags

# Bash 刪除所有Tag
git tag | xargs git tag -d  //Local
git tag -l | xargs -n 1 git push --delete origin  //Remote

Git update-index

若有tracking中的檔案想略過修改追蹤，例如DB連線帳號密碼等修改不想被commit到remote，可以利用update-index*在local取消檔案追蹤：

# 取消本地檔案追蹤
git update-index --assume-unchanged config/database.php

# 復原本地檔案追蹤
git update-index --no-assume-unchanged config/database.php

Git log

git log //將所有 log 秀出
git log --all //秀出所有的 log (含 branch)
git log -p //將所有 log 和修改過得檔案內容列出
git log -p filename //將此檔案的 commit log 和 修改檔案內容差異部份列出
git log --name-only //列出此次 log 有哪些檔案被修改
git log --stat --summary //查每個版本間的更動檔案和行數
git log filename //這個檔案的所有 log
git log directory //這個目錄的所有 log
git log -S'foo()' //log 裡面有 foo() 這字串的.
git log --no-merges //不要秀出 merge 的 log
git log --since="2 weeks ago" //最後這 2週的 log
git log --pretty=oneline //秀 log 的方式
git log --pretty=short //秀 log 的方式
git log --pretty=format:'%h was %an, %ar, message: %s'
git log --pretty=format:'%h : %s' --graph //會有簡單的文字圖形化, 分支等.
git log --pretty=format:'%h : %s' --topo-order --graph //依照主分支排序
git log --pretty=format:'%h : %s' --date-order --graph //依照時間排序

Git show

git show ebff //查 log 是 commit ebff810c461ad1924fc422fd1d01db23d858773b 的內容
git show v1 //查 tag:v1 的修改內容
git show v1:test.txt //查 tag:v1 的 test.txt 檔案修改內容
git show HEAD //此版本修改的資料
git show HEAD^ //前一版修改的資料
git show HEAD^^ //前前一版修改的資料
git show HEAD~4 //前前前前一版修改的資料

Git reset 還原

git reset --hard HEAD  // 還原到最前面
git reset --hard HEAD^  // 還原到前一個commit
git reset --hard HEAD~3
git reset --soft HEAD~3 // 本地檔案不異動，純紀錄異動
git reset HEAD filename  // 從 staging area 狀態回到 unstaging 或 untracked (檔案內容並不會改變)

Git update-ref

git update-ref -d HEAD 刪除HEAD(適用取消首次commit)

Git grep

git grep "te" v1 # 查 v1 是否有 "te" 的字串
git grep "te" # 查現在版本是否有 "te" 的字串

Git stash 暫存

git stash save [] //丟進暫存區(同git stash)
git stash list //列出所有暫存區的資料
git stash pop [] //取出stash並移除，預設最新一筆,
git stash show [] //顯示stash差異，-p顯示diff，預設最新一筆
git stash apply //取出最新的一筆 stash 暫存資料. 但是 stash 資料不移除
git stash drop //把 stash 都清掉
git stash clear //把 stash 都清掉

Git merge 合併

git merge
git merge master
git merge new-branch

# 衝突策略(Conflict strategy)
git merge  -X ours  //衝突時以Current Branch為準
git merge  -X their //衝突時以目標Branch為準

下述轉載自: ihower 的 Git 版本控制系統(2) 開 branch 分支和操作遠端 repo.x

Straight merge 預設的合併模式，會有全部的被合併的 branch commits 記錄加上一個 merge-commit，看線圖會有兩條 Parents 線，並保留所有 commit log。 Squashed commit 壓縮成只有一個 merge-commit，不會有被合併的 log。SVN 的 merge 即是如此。 cherry-pick 只合併指定的 commit rebase 變更 branch 的分支點：找到要合併的兩個 branch 的共同的祖先，然後先只用要被 merge 的 branch 來 commit 一遍，然後再用目前 branch 再 >commit 上去。這方式僅適合還沒分享給別人的 local branch，因為等於砍掉重練 commit log。指令操作

git merge # 合併另一個 branch，若沒有 conflict 衝突會直接 commit。若需要解決衝突則會再多一個 commit。 git merge --squash # 將另一個 branch 的 commit 合併為一筆，特別適合需要做實驗的 fixes bug 或 new feature，最後只留結果。合併完不會幫你先 commit。 git cherry-pick 321d76f # 只合併特定其中一個 commit。如果要合併多個，可以加上 -n 指令就不會先幫你 commit，這樣可以多 pick幾個要合併的 commit，最後再 git commit 即可。

Git Rebase

重改並合併歷史Commit:

git rebase -i [commit]
// -i進入對話模式執行rebase，可以將第一個pick以後都設fixup
pick 6fedbe6 Update README.md
fixup b4c9305 Update README.md
fixup a1d2257 Update README.md
// 上例後兩個commit會直接併回第一個commit

Git blame

git blame filename # 關於此檔案的所有 commit 紀錄

Git 還原已被刪除的檔案

git ls-files -d # 查看已刪除的檔案
git ls-files -d | xargs git checkout -- # 將已刪除的檔案還原

Git 維護

git gc # 整理前和整理後的差異, 可由: git count-objects 看到.
git gc --prune
git fsck --full

Git revert 資料還原

git revert HEAD # 回到前一次 commit 的狀態
git revert HEAD^ # 回到前前一次 commit 的狀態
git reset HEAD filename # 從 staging area 狀態回到 unstaging 或 untracked (檔案內容並不會改變)
git checkout filename # 從 unstaging 狀態回到最初 Repository 的檔案(檔案內容變回修改前)

Conflict Strategy

處理已經衝突的檔案：

git checkout --ours . //以我方(HEAD)策略處理套用全部檔案
git checkout --theirs . //以對方(合併Branch)策略處理套用全部檔案
git checkout --ours filename //單檔處理範例

Git Blame 逐條程式碼Log

git blame [file] //列出此檔逐筆最後異動紀錄
git blame -L 56,62 [file] //僅列出56至62行

Gitignore

Web後端專案根目錄使用範例(PHP)

# windows thumbnail cache
Thumbs.db

# Mac DS_Store Files
.DS_Store

# composer vendor dir
/vendor

保留空資料夾，資料夾內檔案一律忽略 (/folder/.gitingore)：

*
!.gitignore

YIDAS Code