git log用於查詢版本的歷史

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

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

 這條命令有很多參數選項 一、不帶參數

1. 如果不帶任何參數，它會列出所有歷史記錄，最近的排在最上方，顯示提交對象的哈希值，作者、提交日期、和提交說明
2. 如果記錄過多，則按Page Up、Page Down、↓、↑來控制顯示
3. 按q退出歷史記錄列表
4. 
   

  二、顯示參數

1. -p：按補丁顯示每個更新間的差異，比下一條- -stat命令信息更全
2. --stat：顯示每次更新的修改文件的統計信息，每個提交都列出了修改過的文件，以及其中添加和移除的行數，並在最後列出所有增減行數小計
3. --shortstat：只顯示--stat中最後的行數添加修改刪除統計
4. --name-only：盡在已修改的提交信息後顯示文件清單
5. --name-status：顯示新增、修改和刪除的文件清單
6. --abbrev-commit：僅顯示SHA-1的前幾個字符，而非所有的40個字符
7. --relative-date：使用較短的相對時間顯示（例如："two weeks ago"）
8. --graph：顯示ASCII圖形表示的分支合並歷史
9. —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. 內容可以是占位元字符，也可以是直接顯示的普通字符
10. --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

  三、篩選參數：

1. 按數量
   1. -n：顯示前n條log
2. 按日期
   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是一個意思，都可以用
3. 按作者
   1. --author=
      1. 比如git log --author=“John"，顯示John貢獻的commit
      2. 註意：作者名不需要精確匹配，只需要包含就行了
      3. 而且：可以使用正則表達式，比如git log --author="John\|Mary”，搜索Marry和John貢獻的commit
      4. 而且：這個--author不僅包含名還包含email, 所以你可以用這個搜索email
4. 按commit描述
   1. --grep=
      1. 比如：git log --grep="JRA-224"
      2. 而且：可以傳入-i用來忽略大小寫
      3. 註意：如果想同時使用--grep和--author，必須在附加一個--all-match參數
5. 按文件
   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文件夾下所有文件的提交記錄
6. 按分支
   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文件
7. 按內容
   1. -S"<string>"、-G"<string>"
      1. 有時你想搜索和新增或刪除某行代碼相關的commit. 可以使用這條命令
      2. 假設你想知道Hello, World!這句話是什麽時候加入到項目裏去的，可以用：git log -S"Hello,World!"
      3. 另外：如果你想使用正則表達式去匹配而不是字符串, 那麽你可以使用-G代替-S.
      4. 這是一個非常有用的debug工具, 使用他你可以定位所有跟某行代碼相關的commit. 甚至可以查看某行是什麽時候被copy的, 什麽時候移到另外一個文件中去的
      5. 註：-S後沒有"="，與查詢內容之間也沒有空格符
8. 按範圍
   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分支中的提交記錄
9. 過濾掉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
10. 按標簽tag
    1. git log v1.0
       1. 直接這樣是查詢標簽之前的commit
       2. 加兩個點git log v1.0.. 查詢從v1.0以後的提交歷史記錄(不包含v1.0)
11. 按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代表倒數第二次提交

Sample

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