Git中Log輸出format功能 | Git

在日常的軟體開發中，Git 是一個不可或缺的版本控制工具。而其中的 Log（記錄）功能更是開發者們經常使用的一項功能。透過查看 Log，我們可以清楚地了解到專案的歷史紀錄、每一次提交的詳細信息以及作者的資訊等。然而，Git 提供了一些格式化 Log 輸出的功能，使得我們可以更加靈活地呈現這些信息。接下來，讓我們一起來探討一下 Git 中 Formatting the Log Output 的最常用功能吧！

為什麼需要格式化 Log 輸出？

當我們查看 Git Log 時，默認的輸出格式可能會顯得比較雜亂，而且對於想要特定信息的開發者來說，可能需要進行額外的處理才能得到想要的結果。這就是為什麼我們需要格式化 Log 輸出的原因之一。通過格式化，我們可以按照自己的需求，定制化地呈現 Log 的內容，使得閱讀更加方便快捷。

如何格式化 Log 輸出？

Git 提供了一個非常方便的工具——--pretty 參數，用於格式化 Log 輸出。透過這個參數，我們可以指定不同的輸出格式。下面是一些常用的格式：

  1. %H：提交的完整哈希值。
  2. %an：作者姓名。
  3. %ae：作者郵箱。
  4. %s：提交的標題。
  5. %cd：提交日期。

例如，如果我們想要按照一行的格式顯示每次提交的完整哈希值、作者姓名和提交日期，我們可以使用以下命令：

git log --pretty=format:"%H - %an - %cd"

這樣，我們就可以獲得一個比較簡潔的 Log 輸出，只包含了我們需要的信息。

簡易範例

假設我們有以下的提交歷史：

commit 12345678901234567890abcdefabcdefabcdefab
Author: John Doe <john.doe@example.com>
Date:   Mon Feb 14 12:00:00 2024 +0000

    Add feature A

commit 98765432109876543210fedcbaabcdefabcdef01
Author: Jane Smith <jane.smith@example.com>
Date:   Sun Feb 13 10:00:00 2024 +0000

    Fix issue #123

我們可以通過以下命令：

git log --pretty=format:"%H - %an - %cd"

得到以下輸出：

12345678901234567890abcdefabcdefabcdefab - John Doe - Mon Feb 14 12:00:00 2024 +0000
98765432109876543210fedcbaabcdefabcdef01 - Jane Smith - Sun Feb 13 10:00:00 2024 +0000

這樣，我們就得到了格式化後的 Log 輸出，清晰地顯示了每次提交的完整哈希值、作者姓名和提交日期。

結論

在 Git 中，格式化 Log 輸出是一項非常有用的功能，它可以幫助我們更好地理解專案的歷史記錄，提高開發效率。通過適當地使用 --pretty 參數，我們可以根據自己的需求定制化 Log 的輸出格式，使得信息呈現更加清晰、易讀。希望這篇文章能夠幫助到你更好地使用 Git 中的 Log 功能！