爲什麼要看Git日誌？¶

在使用Git進行版本控制時，提交歷史是項目的“成長記錄”。通過查看日誌，你可以瞭解：
- 誰在什麼時候做了什麼修改；
- 項目的迭代軌跡（功能新增、bug修復、重構等）；
- 快速定位某個問題是哪個提交引入的。

最基礎的git log命令¶

最簡單的日誌查看命令是git log，直接運行後會顯示所有提交記錄，默認按最新提交在前的順序展示。
示例輸出（簡化版）：

commit a1b2c3d4e5f67890 (HEAD -> master)
Author: 小明 <xiaoming@example.com>
Date:   Fri Oct 20 14:30:00 2023 +0800
    修復用戶登錄按鈕無法點擊的問題

commit 9876543210fedcba
Author: 小紅 <xiaohong@example.com>
Date:   Thu Oct 19 10:15:00 2023 +0800
    新增用戶註冊頁面

• commit：每次提交的唯一ID（一串亂碼，用於標識提交）；
• Author：提交者和郵箱；
• Date：提交時間；
• 提交信息：描述本次修改的內容（非常重要！要寫清楚）。

常用git log參數（讓日誌更清晰）¶

git log默認輸出信息較多，結合參數可以過濾或簡化日誌，適合不同場景。

1. 簡化顯示：--oneline¶

如果只想快速瀏覽提交歷史，用--oneline把每個提交壓縮成一行，包含提交ID和簡短信息：

git log --oneline

輸出示例：

a1b2c3d 修復用戶登錄按鈕無法點擊的問題
9876543 新增用戶註冊頁面
4567890 初始化項目結構

2. 查看代碼修改：-p（或--patch）¶

想知道某次提交具體改了哪些代碼？用-p顯示每次提交的代碼差異（diff）：

git log -p

輸出會在提交信息後顯示類似diff --git a/file.txt b/file.txt的內容，具體展示新增/刪除的代碼行（紅色爲刪除，綠色爲新增）。
小技巧：按q可退出查看。

3. 限制顯示數量：-n（或--max-count）¶

如果提交太多，只想看最近的5次？用-n 5限制顯示的提交數量：

git log -n 3  # 顯示最近3次提交

4. 圖形化分支結構：--graph¶

當項目有多個分支合併時，用--graph可以用ASCII圖形展示分支和合並關係：

git log --graph --oneline

輸出會顯示類似：

* a1b2c3d 修復登錄按鈕問題
|\
| * e4f5g6h 新增支付功能
|/
* 9876543 優化首頁加載速度

*代表提交，|和/表示分支結構。

5. 按作者/時間過濾：--author/--since/--before¶

• 按作者：git log --author="小明" 只顯示小明的提交；
• 按時間：git log --since="2023-10-01" 顯示10月1日後的提交；--before="2023-10-01" 顯示10月1日前的提交。

6. 彩色顯示：--color¶

讓日誌更易讀，用--color給不同提交加顏色（默認已開啓，可顯式加--color=always確保顏色輸出）：

git log --color --oneline

如何分析提交歷史？¶

學會看日誌後，更重要的是從歷史中提取信息：

1. 找問題源頭：
   若某個功能突然失效，先用git log --oneline看最近幾次提交，再用git log -p對比提交間的差異，快速定位問題提交。

2. 理解分支邏輯：
   用--graph結合分支名（如git log --graph --oneline --all顯示所有分支），能清晰看到哪些提交屬於哪個分支、是否合併。

3. 提交信息的價值：
   好的提交信息（如“修復登錄按鈕問題”而非“改了代碼”）能大幅提升日誌可讀性，便於團隊協作和後續維護。

總結：初學者必備參數清單¶

通過以上命令，你可以輕鬆查看、篩選和分析Git提交歷史，讓版本控制更高效。記住：清晰的提交記錄是團隊協作和個人維護項目的“黃金鑰匙”哦！