git log
命令主要用於查看Git版本演變歷史(也就是提交歷史),同時根據追加的參數和選項不同,也會有不同的展示效果。
但默認git log
命令顯示出的x效果實在太醜,不好好打扮一下根本沒法見人,打扮好了用alias
命令拍個照片,就正式出道了!
1、git log
命令說明
git log
用於查詢版本的歷史,命令形式如下:
git log [<options>] [<since>..<until>] [[--] <path>...]
默認的git log
命令顯示效果如下:
(之前文件詳細說明過了,這裏簡單說一下,主要說明git log
命令的參數)
2、git log
命令參數
這條命令有很多參數選項,下面詳細的說明:
(1)不帶參數
- 如果不帶任何參數,它會列出所有歷史記錄,最近的排在最上方,顯示提交對象的哈希值,作者、提交日期、和提交說明
- 如果記錄過多,則按
上下鍵
,Enter
(向下顯示一行),空格
(顯示下一頁),來控制顯示。 - 按
q
鍵退出歷史記錄列表。
(2)常用顯示參數
-
-p
:按補丁格式顯示每個更新的差異,比下一條--stat
命令信息更全。 -
--stat
:顯示每次提交修改文件的統計信息,每個提交都列出了修改過的文件,以及其中添加和移除的行數,並在最後列出所有增減行數小計。 -
--shortstat
:只顯示--stat
中最後的行數添加、修改、刪除的統計。 -
--name-only
:僅在提交信息後,顯示已修改的文件清單。 -
--name-status
:顯示新增、修改、刪除的文件清單。 -
--abbrev-commit
:僅顯示SHA-1校驗和的前幾個字符,而非所有的40個字符。 -
--relative-date
:使用較短的相對時間,而不是完整格式顯示日期(比如“2 weeks ago”
)。 -
--graph
:在日誌旁以 ASCII 圖形顯示分支與合併歷史。 -
--online
:列表的形式查看歷史版本記錄,--pretty=oneline --abbrev-commit
合用的簡寫。 -
--pretty
:使用其他格式顯示歷史提交信息。可用的選項包括oneline
、short
、full
、fuller
和format
(用來定義自己的格式)。
(3)--pretty
參數
--pretty
:自定義格式化顯示歷史提交信息。
選項有:
1)--pretty=oneline
:一行顯示,只顯示哈希值和提交說明(--online
本身也可以作爲單獨的屬性)。
2)--pretty=format:” "
:控制顯示信息的格式。
序號 | 格式 | 說明 |
---|---|---|
1 | %H |
提交的完整哈希值(commit-id)。 |
2 | %h |
提交的簡寫哈希值。 |
3 | %T |
樹的完整哈希值(tree)。 |
4 | %t |
樹的簡寫哈希值。 |
5 | %P |
父提交(parent)的完整哈希值。 |
6 | %p |
父提交的簡寫哈希值。 |
7 | %an |
作者名字(author)。 |
8 | %ae |
作者的電子郵件地址。 |
9 | %ad |
作者修訂日期(可以用 --date= 選項 來定製格式)。 |
10 | %ar |
作者修訂日期,按多久以前的方式顯示。 |
11 | %cn |
提交者的名字(committer)。 |
12 | %ce |
提交者的電子郵件地址。 |
13 | %cd |
提交日期(可以用 --date= 選項 來定製格式)。 |
14 | %cr |
提交日期,按多久以前的方式顯示。 |
15 | %s |
提交說明。 |
3)--pretty=format:” "
:控制顯示信息的顏色。
-
顏色格式:
%Cred:將顏色切換爲紅色
%Cgreen:將顏色切換爲綠色
%Cblue:將顏色切換爲藍色
%Creset:空格
-
舉例:
執行命令:
git log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %C(cyan)%s %C(magenta)(%cr) %C(bold blue)<%an>%Creset'
兩種效果如下:
-
我們先進行斷句分析:
[%Cred%h][%Creset -][%C(yellow)%d ][%Cblue%s][%Cgreen(%cd)][%C(bold blue)<%an>]
然後就是很明顯能得到的規律了:- 寫法:一個顏色+一個內容,例如
%Cred%h
,依次排寫。 - 顏色以
%C
開頭,後邊接幾種顏色,還可以設置字體,如果要設置字體的話,要一塊加個括號。
能設置的顏色值包括:reset
(默認的灰色),normal
,black
,red
,green
,yellow
,blue
,magenta
,cyan
,white
。(不能單獨使用就加括號)
字體屬性則有bold
,dim
,ul
,blink
,reverse
。 - 內容可以是佔位元字符,也可以是直接顯示的普通字符(例如上面的
-
)
- 寫法:一個顏色+一個內容,例如
(4)--date=
參數
--date=(relative|local|default|iso|rfc|short|raw)
僅對以人類可讀格式顯示的日期生效,例如使用--pretty.log.date
這個config變量設置日誌的默認值。
--date
有幾個默認選項:
-
--date=relative
:顯示相對於當前時間的日期,例如"2小時前"。 -
--date=local
:顯示用戶本地時區中的時間戳。 -
--date=iso
或--date=iso8601
:以ISO 8601
格式顯示時間戳。 -
--date=rfc
或--date=rfc2822
:以RFC 2822
格式顯示時間戳,通常在電子郵件中找到。 -
--date=short
:僅以YYYY-MM-DD
格式顯示日期,而不顯示時間。 -
--date=raw
:以內部原始Git格式%s %z
格式顯示日期。 -
--date=default
:顯示原始時區(提交者或作者)的時間戳。
也可以自定義格式(需要git版本2.6.0以上):
比如:--date=format:'%Y-%m-%d %H:%M:%S'
,會格式化成:2016-01-13 11:32:13
。
其他的格式化佔位符如下:
-
%a
:星期的縮寫。 -
%A
:星期的全名。 -
%b
:月份的縮寫。 -
%B
:月份的全稱。 -
%c
:適用於區域設置的日期和時間表示。 -
%d
:月中的天作爲十進制數字(01 – 31)。 -
%H
: 24小時制的小時(00 – 23)。 -
%I
:2小時格式的小時(01 – 12)。 -
%j
:一年中的天作爲十進制數字(001 – 366)。 -
%m
:以十進制數字表示的月份(01 – 12)。 -
%M
:分鐘以十進制數字表示(00 – 59)。 -
%p
:當前語言環境的"上午/下午",12小時制的指示器。 -
%S
:秒作爲十進制數字(00 – 59)。 -
%U
:一年中的周爲十進制數字,週日爲一週的第一天(00 – 53)。 -
%w
:工作日爲十進制數字(0 – 6;星期日爲0)。 -
%W
:一年中的星期作爲十進制數字,星期一作爲星期的第一天(00 – 53) -
%x
:當前語言環境的日期表示。 -
%X
:當前語言環境的時間表示。 -
%y
:無世紀的年份,爲十進制數字(00 – 99),也就是年份沒有前兩位。 -
%Y
:帶世紀的年份,以十進制數表示。 -
%z
,%Z
:時區名稱或時區縮寫,取決於註冊表設置; 如果時區未知,則沒有字符。 -
%%
:表示百分號。
(5)篩選參數
1)按數量
-
-n
:顯示前n條提交信息。
2)按日期
-
--after=
- 比如
git log --after="2014-7-1”
,顯示2014年7月1號之後的commit(包含7月1號)。 - 後邊的日期還可以用相對時間表示,比如
"1 week ago"
和”yesterday"
,比如git log --after="yesterday"
。
- 比如
-
--before=
:同上。
另外這兩條命令可以同時使用表示時間段,比如git log --after="2014-7-1" --before="2014-7-4"
同理:--since
、--until
和--after
、--before
是一個意思。
--since
, --after
:僅顯示指定時間之後的提交。
--until
, --before
:僅顯示指定時間之前的提交。
3)按作者和提交者
--author=
:僅顯示作者匹配指定字符串的提交。
- 比如
git log --author=“John"
,顯示John貢獻的commit。 - 注意:作者名不需要精確匹配,只需要包含就行了。
- 而且可以使用正則表達式,比如
git log --author="John|Mary”
,搜索Marry和John貢獻的commit。 - 而且這個
--author
不僅包含作者名,還包含作者的email,所以你可以用這個搜索email。
--committer
:僅顯示提交者匹配指定字符串的提交。
4)按commit描述
--grep=
:僅顯示提交說明中包含指定字符串的提交。
- 比如:
git log --grep="JRA-224"
- 而且可以傳入
-i
用來忽略大小寫。 - 注意:如果想同時使用
--grep
和--author
,必須在附加一個--all-match
參數。
5)按文件
--(空格)文件
或--[後邊沒有文件]
- 有時你可能只對某個文件的修改感興趣,或你只想查看跟某個文件相關的歷史信息,你只需要插入你感興趣文件的路徑,[對,是路徑,所以經常是不太好用]就可以了。
- 比如:
git log -- foo.py bar.py
,只返回和foo.py
文件或bar.py
文件的相關commit。 - 這裏的
--
是告訴Git,後面的參數是文件路徑而不是branch(分支)的名字。 如果後面的文件路徑不會和某個branch產生混淆,你可以省略--
,比如git log foo.py
。 - 另外,後邊的路徑還支持正則,比如:
git log *install.md
,是指定項目路徑下的所有以install.md
結尾文件的提交歷史。 - 另外,文件名應該放到參數的最後位置,通常在前面加上
--
並用空格隔開表示是文件。 - 另外,
git log file/
,可以查看file文件夾下所有文件的提交記錄。
6)按分支
--
:
--branchName branchName
參數:爲任意一個分支名字,查看某個分支上的提交記錄。需要放到參數中的最後位置處。
-
如果分支名與文件名相同,系統會提示錯誤,可通過
--
選項,來指定給定的參數,是分支名還是文件名。比如:在當前分支中有一個名爲v1的文件,同時還存在一個名爲v1的分支。如下:
git log v1 --
,此時的v1代表的是分支名字(--
後邊是空的)。git log -- v1
,此時的v1代表的是名爲v1的文件。git log v1 -- v1
:代表v1分支下的v1文件。
7)按內容
-S"<string>"
、-G"<string>"
:僅顯示添加或刪除內容匹配指定字符串的提交。
- 有時你想搜索,新增或刪除某行代碼相關的commit. 可以使用這條命令。
- 假設你想知道
Hello,World!
這句話,是什麼時候加入到項目裏去的,可以用:git log -S"Hello,World!"
。 - 另外,如果你想使用正則表達式去匹配,而不是字符串,那麼你可以使用
-G
代替-S
。 - 這是一個非常有用的debug工具,使用他可以定位所有跟某行代碼相關的commit,甚至可以查看某行是什麼時候被copy的,什麼時候移到另外一個文件中去的。
- 注意:
-S
後沒有"="
,與查詢內容之間也沒有空格符。
8)按範圍
git log <since>..<until>
:
- 這個命令可以查看某個範圍的commit。
- 這個命令非常有用當你使用branch做爲range參數的時候. 能很方便的顯示2個branch(分支)之間的不同。
- 比如:
git log master..feature
,master..feature
這個range(範圍),包含了在feature
分支存在,而在master
分支沒有的所有commit。同樣,如果是feature..master
,意思是包含所有master
分支有,但是feature
分支沒有的commit。 - 另外,如果是三個點,表示或的意思:
git log master...test
,意思是查詢master
或test
分支中的提交記錄。
9)過濾掉merge commit
--no-merges
:
- 默認情況下
git log
會輸出merge commit
(合併提交)。你可以通過--no-merges
標記來過濾掉merge commit,例如:git log --no-merges
。 - 另外,如果你只對merge commit感興趣可以使用
--merges
參數,例如:git log --merges
。
10)按標籤tag
git log v1.0
:
- 直接這樣是查詢標籤之前的commit。
- 加兩個點,例如:
git log v1.0..
,是查詢從v1.0
以後的提交歷史記錄(不包含v1.0)。
11)按commit
-
git log commit
:查詢commit之前的記錄,包含commit。 -
git log commit1 commit2
:查詢commit1與commit2之間的記錄,包括commit1和commit2。 -
git log commit1..commit2
:同上,但是不包括commit1。
說明:
- 其中,commit可以是提交哈希值的簡寫模式,也可以使用HEAD代替。
- HEAD代表最後一次提交,
HEAD^
爲最後一個提交的父提交,等同於HEAD~1
。 -
HEAD~2
代表倒數第二次提交。
提示:Git的指令是非常豐富的,通過
git help log
或者git help --web log
,可以以瀏覽器的方式查看更多關於log的指令。
參考: