The Will Will Web

記載著 Will 在網路世界的學習心得與技術分享

GitHub for Windows 內建 Git Shell 執行時顏色所代表的意義

在使用指令列版控的過程中,經常有機會用到 Git Shell 這套優異的 Git 版控環境,一來他使用 Windows PowerShell 為核心,其訊息顯示與輸入都支援 Unicode,比較不會有中文字集轉換的問題;二來輸入命令或分支名稱的時候還有 IntelliSense 功能協助,非常貼心的設計;三來在版控的過程中,可以看出當下工作目錄位於哪個分支上,這個提示也很棒;四來常會看到他透過顏色與一些特殊符號提示你目前工作目錄的狀態,但不特別看文件還真的不太容易知道它顏色代表的意義,因此特別撰文解說。

不同的分支顏色所代表的意義

  • 青色 (Cyan),代表本地儲存庫遠端儲存庫同步狀態

  • 紅色 (Red),代表目前本地儲存庫的版本比遠端儲存庫還落後 (behind),意思是遠端儲存庫擁有目前本地儲存庫沒有的版本,需要透過 git pull遠端儲存庫的變更抓回來更新本地儲存庫
    如下圖示,代表目前遠端儲存庫上有 1 個版本 (commit) 需要同步回來:

  • 黃色 (Yellow),代表目前本地儲存庫有些版本比遠端儲存庫落後 (behind),同時間也有些版本比遠端儲存庫還超前 (ahead),意思是說,目前遠端儲存庫擁有目前本地儲存庫沒有的版本,而且本地儲存庫也擁有遠端儲存庫沒有的版本,代表你需要先做 git pull遠端儲存庫的變更抓回來更新本地儲存庫,也需要透過 git push本地儲存庫的版本變更推送上去。注意:由於遠端本地都有版本變更,這代表透過 git pull 抓取變更回來時,勢必要面對「合併」的議題,也就是可能會遇見「合併衝突」的狀況。

  • 綠色 (Green),代表目前本地儲存庫有些版本比遠端儲存庫超前 (aheads),意思是說本地儲存庫擁有遠端儲存庫沒有的版本,你需要透過 git push 把本地變更推送到遠端儲存庫。
    如下圖示,當我們先用 git pull 把遠端儲存庫的變更抓回來合併或更新之後,顏色馬上變成「綠色」了,也就是這個時候執行 git push 是最安全的(不會有衝突事件發生),你可以這樣思考:【當看到綠燈的時候,就是可以推送版本上去的時刻!


    如下圖,你可以發現,只要我把本地儲存庫的變更推送上去後,顏色就立刻變回青色 (Cyan)了!

工作目錄檔案狀態符號與顏色所代表的意義

在 Git Shell 執行環境中,經常出現的一些有顏色的數字提示,其數字前的符號所代表的意義如下:

  • + = 有 n 個新增檔案
  • ~ = 有 n 個檔案被更新
  • - = 有 n 個檔案被刪除
  • ! = 有 n 個檔案在合併的時候發生衝突

其顏色所代表的意義如下:

  • 暗紅色 (Dark Red),代表這些檔案處於 Untracked 或 Not Staged 狀態 (不會被 commit 的檔案)
  • 暗綠色 (Dark Green),代表這些檔案處於 Staged 狀態 (會被 commit 的檔案數

以下圖示各位可以看圖說故事一番:

相關連結