MasterDragon

本頁是唯讀的，您可以看到原始碼，但不能更動它。您如果覺得它不應被鎖上，請詢問管理員。
====== [Git] .git版本控制系統 – 指令速查表 (彙整教學) ======
https://code.yidas.com/git-commands/

注意事項

由 project/.git/config 可知當前Config

origin(remote) 是 Repository 的版本\\
master(branch) 是 local 端, 正在修改的版本\\
平常沒事不要去動到 origin, 如果動到, 可用 git reset –hard 回覆到沒修改的狀態.\\

----

===== Config – 環境設定 =====
<code>
git config --global user.name "Nick"
git config --global user.email nick@example.com
git config --global color.ui true  //打開 Git 的 color 顏色設定，如 git status
</code>
因為初次未設定，從 git config –list 會找不到該參數名，所以列上
<code>
git config --global --unset user.name # 移除KEY
</code>
----

===== Remote – 遠端設定 =====
<code>
# 列出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
git remote rm new-origin
</code>

----

===== Pull – 從遠端更新 =====
<code>
git pull //預設為origin Master
git pull origin master
</code>
實際作用原理為先 git fetch 遠端的 branch，然後與本地端的 branch 做 merge，產生一個 merge commit 節點

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

----

===== Push – 將 Commit 送出去 =====
<code>
git push //預設為origin Master
git push origin master
</code>
實際的作用原理為將本地端的 master branch 與遠端的 master branch 作 fast-forward 合併。如果出現 [rejected] 錯誤的話，表示你必須先作 pull。
<code>
git push origin +HEAD
git push origin +HEAD:{brach}   // 適用於搭配reset刪除遠端commit
</code>

----

===== Git 新增檔案git add . =====

將資料先暫存到 staging area, add 之後再新增的資料, 於此次 commit 不會含在裡面.
<code>
git add filename
git add modify-file //修改過的檔案, 也要 add. (不然 commit 要加上 -a 的參數)
git add -u //只加修改過的檔案, 新增的檔案不加入.
git add -i //進入互動模式
</code>

----

===== Git 刪除檔案 =====
<code>
git rm filename
</code>

----

===== Git 清除Cache =====

例如Git含有submodule欲刪除後，需要清空.git/index Cache以讓Main module追蹤原submodule目錄。
<code>
git rm --cached -r folder
</code>

----

===== Git 修改檔名、搬移目錄 =====
<code>
git mv filename new-filename
</code>

----

===== Git status 看目前的狀態 =====
<code>
git status
</code>

----

===== Git Commit =====
<code>
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
</code>

----

===== Git Branch =====

==== Git Branch 基本操作 ====
<code>
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 <new-branch-name>
git branch -m <old-branch> <new-branch-name>

# 刪除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
</code>

----

==== Git checkout 切換 branch ====
<code>
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 的狀態(* 改成檔名, 就可以只恢復那個檔案)
</code>

----

==== Git remote branch 維護遠端分支檔案 ====
<code>
# 更新所有 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
</code>

----

==== 抓取 / 切換 Repository 的 branch ====
<code>
git fetch origin
git checkout --track -b reps-branch origin/reps-branch # 抓取 reps-branch, 並將此 branch 建立於 local 的 reps-branch
</code>

----

==== Git track all remote branch 抓取所有遠端分支 ====
<code>
# 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 //其實結果同上
</code>

----

===== Git diff =====
<code>
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
</code>

----

===== Git Tag =====
<code>
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
</code>

----

===== Git log =====
<code>
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 //依照時間排序
</code>

----

===== Git show =====
<code>
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 //前前前前一版修改的資料
</code>

----

===== Git reset 還原 =====
<code>
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 (檔案內容並不會改變)
</code>

----

===== Git update-ref =====
<code>
git update-ref -d HEAD 刪除HEAD(適用取消首次commit)
</code>

----

===== Git grep =====
<code>
git grep "te" v1 # 查 v1 是否有 "te" 的字串
git grep "te" # 查現在版本是否有 "te" 的字串
</code>

----

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

----

===== Git merge 合併 =====
<code>
git merge
git merge master
git merge new-branch

# 衝突策略(Conflict strategy)
git merge <branch> -X ours  //衝突時以Current Branch為準
git merge <branch> -X their //衝突時以目標Branch為準
</code>
下述轉載自: 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。\\
\\
指令操作\\
<code>
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 即可。
</code>
----

===== Git Rebase =====

重改並合併歷史Commit:
<code>
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
</code>

----

===== Git blame =====
<code>
git blame filename # 關於此檔案的所有 commit 紀錄
</code>

----

===== Git 還原已被刪除的檔案 =====
<code>
git ls-files -d # 查看已刪除的檔案
git ls-files -d | xargs git checkout -- # 將已刪除的檔案還原
</code>

----

===== Git 維護 =====
<code>
git gc # 整理前和整理後的差異, 可由: git count-objects 看到.
git gc --prune
git fsck --full
</code>

----

===== Git revert 資料還原 =====
<code>
git revert HEAD # 回到前一次 commit 的狀態
git revert HEAD^ # 回到前前一次 commit 的狀態
git reset HEAD filename # 從 staging area 狀態回到 unstaging 或 untracked (檔案內容並不會改變)
git checkout filename # 從 unstaging 狀態回到最初 Repository 的檔案(檔案內容變回修改前)
</code>

----

===== Conflict Strategy =====

處理已經衝突的檔案：
<code>
git checkout --ours . //以我方(HEAD)策略處理套用全部檔案
git checkout --theirs . //以對方(合併Branch)策略處理套用全部檔案
git checkout --ours filename //單檔處理範例
</code>

----

===== Git Blame 逐條程式碼Log =====
<code>
git blame [file] //列出此檔逐筆最後異動紀錄
git blame -L 56,62 [file] //僅列出56至62行
</code>