前言：場景說明

最近因為需要 review 同事的 code，「比較分支差異」成為了一個硬需求。

工作中，通常一個功能會分配給一個開發者以一個獨立分支進行開發。當功能分支開發告一段落，想要對這些修改部分的程式碼進行 reivew，就得先明確「從 develop 分支到目前功能分支」的所有變更。

換句話說，此時分支範圍內通常會包括多個 commit 與多個檔案的變動，我們需要能夠一次就看到分支累積的所有變動。本來我都是一個一個 commit 慢慢看，土法煉鋼，但顯然這真的是太蠢了！還好很快就受不了，找到更好的辦法。

本篇重點

本文分為兩部分：

  1. 流程教學：使用 GitLens 比較不同分支差異的步驟與圖解。
  2. 補充：SourceTree 快速比較分支做法。

git diff 的不足

提到比較分支，第一個想到的八成是git diff指令吧！但我相信用的人應該不多，其輸出效果如下：

git diff on CLIgit diff on CLI

畢竟是命令列工具，輸出格式就不太人類友好，主要的不便在於：多個檔案的變動只能用捲軸或換頁慢慢看，且很難在不同檔案之間來回比對。只能說，如果是想簡單看幾眼了解大概差異的話那還可以（但下面依舊有更好的做法），要進行 code reivew 用這個就太不方便了！

所以下面要介紹兩種更有效率的做法。

分支差異即 commit 差異

不過介紹前還是要再次提醒，就像《為你自己學 Git》一書中說的，分支只是附著在 commit 上的一張「貼紙」而已，所以比較分支差異本質上就是比較 commit 差異。

VS Code + GitLens

GitLens 是 VS Code 上一個和 Git 相關的擴充套件（extension），功能強大，最常用的可能是每一個程式行後的 git blame 訊息：

inline git blameinline git blame

此外還有許多特性，比如以關鍵字搜尋 commit 標題、前後 commit 變動比較等等，我也不完全熟悉，在此先不提，直接進入主題吧！

使用 GitLens 比較分支、commit，步驟很簡單，可對照下圖操作：

Compare ReferencesCompare References

  1. 選擇左邊 VS Code 工具列的 Git。
  2. 打開「Search & Compare」功能分頁。
  3. 按下「Compare Reference」，這裡的 reference 基本上指的就是 commit，不過會讓你優先選擇分支或標籤，也可以使用#號並輸入 commit 的 SHA。
  4. 第一次選擇分支：選擇被比較的開發分支！可以認為是本次比較的主角，比如選擇「1231-create-iot-device」分支。
  5. 第二次選擇分支：選擇用以比較的基準分支，也就是 develop 分支。
    1. 注意，最好先選擇 commit 時間靠後的分支，也就是開發分支，再選擇時間靠前的分支，這樣呈現出來的變動差異通常才是我們想要的。
    2. 如果順序相反，則+會變成-，這裡被比較分支和基準分支的擺放順序和git diff正好相反，也就是想要有同樣的輸出結果，git 指令是git diff develop 1231-create-iot-device，develop變成第一個參數。

選完後，就會出現所有變動的檔案清單，本例中總共有 6 個檔案所有變動，一目瞭然，而且會以圖示來表示該檔是僅有增加程式碼或減少，或兩者皆有。

點進任一檔名，就是我們熟悉的 VS Code diff 畫面，視覺上還是比命令列友善許多。

這就是我最常用的分支比較方式，非常方便且直觀，強力推薦！

SourceTree

本來有第一種方法我已經滿足，但後來也好奇，我使用的 Git GUI 即 SourceTree，要如何做到類似的事呢？

結果一查才發現，哇，驚人的簡單！只需要在 commit 清單中按住cmd（也就是 Windows 的ctrl）後，再任意選取兩個 commit 即可！

SourceTree 會顯示這兩個 commit 之間，所有變動的「檔案清單」與「修改內容」：

SourceTree 會以「時間較早」的 commit 為比較的「基準」SourceTree 會以「時間較早」的 commit 為比較的「基準」

實際上你可以選擇「超過兩個」commit，但並沒有什麼差別，SourceTree 只會去比較這些選擇的 commit 中，時間最早和最晚兩個 commit 的差異，這點要稍稍注意。

在只想大概了解分支變動的情況下，使用 SourceTree 來比較分支，無疑比git diff指令更加快速且人性化許多，只需要短短 1 秒鐘即可看到結果，十分舒爽！

參考