10. 歷史 · 沉浸式學 Git

## 目的 > 學習如何查看項目的歷史。獲得已經做過的更改清單是?`git log`?命令的功能。 ~~~ $ git log ~~~ 你應該看到： ~~~ $ git log commit 1f7ec5eaa8f37c2770dae3b984c55a1531fcc9e7 Author: Jim Weirich <jim (at) neo.com> Date: Sat Apr 13 15:20:42 2013 -0400 Added a comment commit 582495ae59ca91bca156a3372a72f88f6261698b Author: Jim Weirich <jim (at) neo.com> Date: Sat Apr 13 15:20:42 2013 -0400 Added a default value commit 323e28d99a07d404c04f27eb6e415d4b8ab1d615 Author: Jim Weirich <jim (at) neo.com> Date: Sat Apr 13 15:20:42 2013 -0400 Using ARGV commit 94164160adf8faa3119b409fcfcd13d0a0eb8020 Author: Jim Weirich <jim (at) neo.com> Date: Sat Apr 13 15:20:42 2013 -0400 First Commit ~~~ 這份清單是迄今為止我們對倉庫所作的總共 4 次提交。 ### 單行歷史你可以很好的控制處理?`log`?命令要精確顯示的內容。我喜歡單行格式： ~~~ $ git log --pretty=oneline ~~~ 你應該看到： ~~~ $ git log --pretty=oneline 1f7ec5eaa8f37c2770dae3b984c55a1531fcc9e7 Added a comment 582495ae59ca91bca156a3372a72f88f6261698b Added a default value 323e28d99a07d404c04f27eb6e415d4b8ab1d615 Using ARGV 94164160adf8faa3119b409fcfcd13d0a0eb8020 First Commit ~~~ ### 控制顯示哪個條目 `log`?命令有許多選項用來選擇顯示哪個條目。玩玩下面的選項： ~~~ $ git log --pretty=oneline --max-count=2 $ git log --pretty=oneline --since='5 minutes ago' $ git log --pretty=oneline --until='5 minutes ago' $ git log --pretty=oneline --author=<your name> $ git log --pretty=oneline --all ~~~ 參閱?`man git-log`?了解更多細節。 ### 更加漂亮這是我用來復查上周所做更改的命令。如果我只想看自己所作的更改，那么我將添加`--author=jim`。 ~~~ $ git log --all --pretty=format:'%h %cd %s (%an)' --since='7 days ago' ~~~ ### 終極日志格式隨著時間的推移，我發現在工作時最喜歡下列日志格式。 ~~~ $ git log --pretty=format:'%h %ad | %s%d [%an]' --graph --date=short' ~~~ 它看起來像這樣： ~~~ $ git log --pretty=format:'%h %ad | %s%d [%an]' --graph --date=short * 1f7ec5e 2013-04-13 | Added a comment (HEAD, master) [Jim Weirich] * 582495a 2013-04-13 | Added a default value [Jim Weirich] * 323e28d 2013-04-13 | Using ARGV [Jim Weirich] * 9416416 2013-04-13 | First Commit [Jim Weirich] ~~~ 讓我們看一下細節： * `--pretty="..."`?定義輸出的格式 * `%h`?是提交 hash 的縮寫 * `%d`?是提交的裝飾（如分支頭或標簽） * `%ad`?是創作日期 * `%s`?是注釋 * `%an`?是作者姓名 * `--graph`?使用 ASCII 圖形布局顯示提交樹 * `--date=short`?保留日期格式更好且更短 ### 其它工具 gitx (Mac) 和 gitk (任意平臺) 在瀏覽日志歷史時十分有用。