git log命令全解析，打log還能這麼爲所欲爲！

時間 2019-11-06

標籤 git log 命令解析還能爲所欲爲欄目 Git 简体版

原文原文鏈接

git log命令很是強大而好用，在複雜系統的版本管理中扮演着重要的角色，但默認的git log命令顯示出的東西實在太醜，很差好打扮一下根本無法見人，打扮好了用alias命令拍個照片，就正式出道了！

下面先詳細而系統地介紹git log的全部配置知識（用我一貫簡潔清晰的表述方式），熟悉了這些東西，你就能夠自由配置本身美麗的git log了～

最後上個乾貨，直接給一個我打扮好的alias配置，懶人直接跳到最後吧！

（轉載請註明：博客園-閣剛廣志，地址：http://www.cnblogs.com/bellkosmos/p/5923439.html ）

git log用於查詢版本的歷史，命令形式以下：

git log [<options>] [<since>..<until>] [[--] <path>...]

這條命令有不少參數選項

1、不帶參數

若是不帶任何參數，它會列出全部歷史記錄，最近的排在最上方，顯示提交對象的哈希值，做者、提交日期、和提交說明
若是記錄過多，則按Page Up、Page Down、↓、↑來控制顯示
按q退出歷史記錄列表

2、顯示參數

-p：按補丁顯示每一個更新間的差別，比下一條- -stat命令信息更全
--stat：顯示每次更新的修改文件的統計信息，每一個提交都列出了修改過的文件，以及其中添加和移除的行數，並在最後列出全部增減行數小計
--shortstat：只顯示--stat中最後的行數添加修改刪除統計
--name-only：盡在已修改的提交信息後顯示文件清單
--name-status：顯示新增、修改和刪除的文件清單
--abbrev-commit：僅顯示SHA-1的前幾個字符，而非全部的40個字符
--relative-date：使用較短的相對時間顯示（例如："two weeks ago"）
--graph：顯示ASCII圖形表示的分支合併歷史
—pretty＝：使用其餘格式顯示歷史提交信息，可選項有：oneline,short,medium,full,fuller,email,raw以及format:<string>,默認爲medium，如：
1. --pretty=oneline：一行顯示，只顯示哈希值和提交說明（--online自己也能夠做爲單獨的屬性）
2. --pretty=format:」 "：控制顯示的記錄格式，如：
  1. %H 提交對象（commit）的完整哈希字串
  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)的名字
    1. 做者和提交者的區別不知道是啥？
    2. 做者與提交者的關係：做者是程序的修改者，提交者是代碼提交人（本身的修改不提交是怎麼能讓別人拉下來再提交的？）
    3. 其實做者指的是實際做出修改的人，提交者指的是最後將此工做成果提交到倉庫的人。因此，當你爲某個項目發佈補丁，而後某個核心成員將你的補丁併入項目時，你就是做者，而那個核心成員就是提交者（soga）
  12. %ce 提交者的電子郵件地址
  13. %cd 提交日期（能夠用 -date= 選項定製格式）
  14. %cr 提交日期，按多久之前的方式顯示
  15. %s 提交說明
3. 帶顏色的--pretty=format:」 "，這個另外寫出來分析
  1. 以這句爲例：%Cred%h%Creset -%C(yellow)%d%Cblue %s %Cgreen(%cd) %C(bold blue)<%an>
  2. 它的效果是：
  3. 先斷句：［%Cred%h］［%Creset -］［%C(yellow)%d ］［%Cblue%s］［%Cgreen(%cd)］［%C(bold blue)<%an>］
  4. 而後就是很明顯能獲得的規律了
    1. 一個顏色＋一個內容
    2. 顏色以％C開頭，後邊接幾種顏色，還能夠設置字體，若是要設置字體的話，要一塊加個括號
      1. 能設置的顏色值包括：reset（默認的灰色），normal, black, red, green, yellow, blue, magenta, cyan, white.
      2. 字體屬性則有bold, dim, ul, blink, reverse.
    3. 內容能夠是佔位元字符，也能夠是直接顯示的普通字符
--date= (relative|local|default|iso|rfc|short|raw)：定製後邊若是出現%ad或%cd時的日期格式
1. 有幾個默認選項
  1. --date=relative：shows dates relative to the current time, e.g. "2 hours ago".
  2. --date=local：shows timestamps in user’s local timezone.
  3. --date=iso (or --date=iso8601)：shows timestamps in ISO 8601 format.
  4. --date=rfc (or --date=rfc2822)：shows timestamps in RFC 2822 format,often found in E-mail messages.
  5. --date=short：shows only date but not time, in YYYY-MM-DD format.這個挺好用
  6. --date=raw：shows the date in the internal raw git format %s %z format.
  7. --date=default：shows timestamps in the original timezone (either committer’s or author’s).
2. 也能夠自定義格式（須要git版本2.6.0以上），好比--date=format:'%Y-%m-%d %H:%M:%S' 會格式化成：2016-01-13 11:32:13，其餘的格式化佔位符以下：
  1. %a：Abbreviated weekday name
  2. %A：Full weekday name
  3. %b：Abbreviated month name
  4. %B：Full month name
  5. %c：Date and time representation appropriate for locale
  6. %d：Day of month as decimal number (01 – 31)
  7. %H： Hour in 24-hour format (00 – 23)
  8. %I：Hour in 12-hour format (01 – 12)
  9. %j：Day of year as decimal number (001 – 366)
  10. %m：Month as decimal number (01 – 12)
  11. %M：Minute as decimal number (00 – 59)
  12. %p：Current locale's A.M./P.M. indicator for 12-hour clock
  13. %S：Second as decimal number (00 – 59)
  14. %U：Week of year as decimal number, with Sunday as first day of week (00 – 53)
  15. %w：Weekday as decimal number (0 – 6; Sunday is 0)
  16. %W：Week of year as decimal number, with Monday as first day of week (00 – 53)
  17. %x：Date representation for current locale
  18. %X：Time representation for current locale
  19. %y：Year without century, as decimal number (00 – 99)
  20. %Y：Year with century, as decimal number
  21. %z, %Z：Either the time-zone name or time zone abbreviation, depending on registry settings; no characters if time zone is unknown
  22. %%：Percent sign

3、篩選參數：

按數量
1. -n：顯示前n條log
按日期
1. --after=
  1. 好比git log --after="2014-7-1」，顯示2014年7月1號以後的commit(包含7月1號)
  2. 後邊的日期還能夠用相對時間表示，好比"1 week ago"和」yesterday"，好比git log --after="yesterday"
  3. 這裏的格式能夠是什麼？
2. --before=
  1. 同上
  2. 另外這兩條命令能夠同時使用表示時間段，好比git log --after="2014-7-1" --before="2014-7-4"
  3. 另外--since --until和 --after --before是一個意思，均可以用
按做者
1. --author=
  1. 好比git log --author=「John"，顯示John貢獻的commit
  2. 注意：做者名不須要精確匹配，只須要包含就好了
  3. 並且：可使用正則表達式，好比git log --author="John\|Mary」，搜索Marry和John貢獻的commit
  4. 並且：這個--author不只包含名還包含email, 因此你能夠用這個搜索email
按commit描述
1. --grep=
  1. 好比：git log --grep="JRA-224"
  2. 並且：能夠傳入-i用來忽略大小寫
  3. 注意：若是想同時使用--grep和--author，必須在附加一個--all-match參數
按文件
1. - -（空格）或［沒有］
  1. 有時你可能只對某個文件的修改感興趣, 你只想查看跟某個文件相關的歷史信息, 你只須要插入你感興趣文件的路徑［對，是路徑，因此常常是不太好用］就能夠了
  2. 好比：git log -- foo.py bar.py ，只返回和foo.py或bar.py相關的commit
  3. 這裏的--是告訴Git後面的參數是文件路徑而不是branch的名字. 若是後面的文件路徑不會和某個branch產生混淆, 你能夠省略- -，好比git log foo.py
  4. 另外，後邊的路徑還支持正則，好比：git log *install.md 是，指定項目路徑下的全部以install.md結尾的文件的提交歷史
  5. 另外，文件名應該放到參數的最後位置，一般在前面加上--並用空格隔開表示是文件
  6. 另外，git log file/ 查看file文件夾下全部文件的提交記錄
按分支
1. - -
  1. --branchName branchName爲任意一個分支名字，查看某個分支上的提交記錄
  2. 須要放到參數中的最後位置處
  3. 若是分支名與文件名相同，系統會提示錯誤，可經過--選項來指定給定的參數是分支名仍是文件名
    1. 好比：在當前分支中有一個名爲v1的文件，同時還存在一個名爲v1的分支
    2. git log v1 -- 此時的v1表明的是分支名字（－－後邊是空的）
    3. git log -- v1 此時的v1表明的是名爲v1的文件
    4. git log v1 －－ v1 表明v1分支下的v1文件
按內容
1. -S"<string>"、-G"<string>"
  1. 有時你想搜索和新增或刪除某行代碼相關的commit. 可使用這條命令
  2. 假設你想知道Hello, World!這句話是何時加入到項目裏去的，能夠用：git log -S"Hello,World!"
  3. 另外：若是你想使用正則表達式去匹配而不是字符串, 那麼你可使用-G代替-S.
  4. 這是一個很是有用的debug工具, 使用他你能夠定位全部跟某行代碼相關的commit. 甚至能夠查看某行是何時被copy的, 何時移到另一個文件中去的
  5. 注：-S後沒有"="，與查詢內容之間也沒有空格符
按範圍
1. git log <since>..<until>
  1. 這個命令能夠查看某個範圍的commit
  2. 這個命令很是有用當你使用branch作爲range參數的時候. 能很方便的顯示2個branch之間的不一樣
  3. 好比：git log master..feature，master..feature這個range包含了在feature有而在master沒有的全部commit，一樣，若是是feature..master包含全部master有可是feature沒有的commit
  4. 另外，若是是三個點，表示或的意思：git log master...test 查詢master或test分支中的提交記錄
過濾掉merge commit
1. --no-merges
  1. 默認狀況下git log會輸出merge commit. 你能夠經過--no-merges標記來過濾掉merge commit，git log --no-merges
  2. 另外，若是你只對merge commit感興趣可使用—merges，git log --merges
按標籤tag
1. git log v1.0
  1. 直接這樣是查詢標籤以前的commit
  2. 加兩個點git log v1.0.. 查詢從v1.0之後的提交歷史記錄(不包含v1.0)
按commit
1. git log commit ：查詢commit以前的記錄，包含commit
2. git log commit1 commit2：查詢commit1與commit2之間的記錄，包括commit1和commit2
3. git log commit1..commit2：同上，可是不包括commit1
  1. 其中，commit能夠是提交哈希值的簡寫模式，也可使用HEAD代替
    1. HEAD表明最後一次提交，HEAD^爲最後一個提交的父提交，等同於HEAD～1
    2. HEAD～2表明倒數第二次提交

最後乾貨，你會喜歡的~

下面第一條的效果是這樣：

git config --global alias.lm  "log --no-merges --color --date=format:'%Y-%m-%d %H:%M:%S' --author='你的名字！本身修改！' --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Cblue %s %Cgreen(%cd) %C(bold blue)<%an>%Creset' --abbrev-commit"


git config --global alias.lms  "log --no-merges --color --stat --date=format:'%Y-%m-%d %H:%M:%S' --author='你的名字！本身修改！' --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Cblue %s %Cgreen(%cd) %C(bold blue)<%an>%Creset' --abbrev-commit"


git config --global alias.ls "log --no-merges --color --graph --date=format:'%Y-%m-%d %H:%M:%S' --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Cblue %s %Cgreen(%cd) %C(bold blue)<%an>%Creset' --abbrev-commit"


git config --global alias.lss "log --no-merges --color --stat --graph --date=format:'%Y-%m-%d %H:%M:%S' --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Cblue %s %Cgreen(%cd) %C(bold blue)<%an>%Creset' --abbrev-commit"

參考資料：

http://www.cnblogs.com/irocker/p/advanced-git-log.html

http://stackoverflow.com/questions/7853332/git-log-date-formats

https://git-scm.com/docs/git-log