git commit 撰寫多行訊息

除了使用整合開發工具 commit 以外,平時只會使用下面的指令進行最簡單的單行 commit:
    
git commit -m "✨ 新增會員系統"
    

延伸閱讀:使用小圖示(Emoji)建立一目瞭然 commit 訊息

那,該如何撰寫多行 commit 訊息呢?

直接換行

我們在寫訊息時為了應對有空白的情況,通常會在前後加上雙引號("),若未加上結尾的雙引號,直接按下 Enter,則該換行也會被視為訊息的一部份,訊息結尾再補上雙引號即可:
    
git commit -m "✨ 新增會員系統

串接 Email 發送驗證碼
首頁右上角增加會員資訊顯示"
    

使用多個 -m 參數

-m 參數可以重複使用,每個內容中間會有一個獨立的空白
    
git commit -m "✨ 新增會員系統" -m "串接 Email 發送驗證碼"
    

使用 vim 模式編輯

雖然上述的方式已經足夠使用,不過或許有的時候還是需要使用最原始的方式 - 使用 vim 編輯 commit 訊息

在輸入 commit 指令並不附加 -m 參數後就會進入到編輯頁面
    
git commit
    

應該會顯示類似下面的內容:
    
# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
#
# On branch master
# Changes to be committed:
#       modified:   file/test1.txt
#
    

這時候可以使用方向鍵(或 h, j, k, l) 移動游標,在最後一行按下 o 以在游標下一行新增空行並切換為輸入模式,編輯完成後使用指令 :wq 儲存並離開編輯模式即完成 commit。若該行為井號(#) 開頭則會被略過。

留言