在所有的git教程里,git commit肯定是一開(kāi)始就會(huì)提到的命令。一般情況下每個(gè)commit都會(huì)有一段commit log message芦缰。message可能有一行內(nèi)容掘猿,可能有多行內(nèi)容,中間可能會(huì)有空白行。在第一個(gè)空白行前面的部分稱(chēng)為subject,之后的部分稱(chēng)為body。subject和body在git log或者git show的輸出format中分別可以用%s和%b獲得喳瓣,也可以用%B同時(shí)獲得subject和body,等價(jià)于%s%b赞别。在進(jìn)行項(xiàng)目開(kāi)發(fā)的時(shí)候畏陕,事先約定好message的格式并且讓大家都遵守這個(gè)約定,是比較好的做法氯庆。在用git commit生成一個(gè)commit的時(shí)候蹭秋,message的輸入方法有很多種:
1. 最常見(jiàn)的做法是用-m <msg>參數(shù),等價(jià)于--message <msg>堤撵。在message只有一行內(nèi)容時(shí)仁讨,用這種方式比較方便,但如果要輸入很多行的話(huà)实昨,就不是那么方便了洞豁。
git commit -m 'hello world'
2. 第二種做法是什么參數(shù)都不要帶,直接就用git commit荒给。這會(huì)啟動(dòng)文本編輯器丈挟,打開(kāi).git/COMMIT_EDITMSG,在里面輸入想要的message志电,然后保存退出就可以了曙咽。這種方式非常自由靈活,想要什么輸入什么挑辆。
git commit
3. 人總是趨向于偷懶的例朱,每次都要手動(dòng)輸入一堆東西肯定嫌煩。那有沒(méi)有辦法可以利用現(xiàn)有資源呢鱼蝉?git commit提供了一個(gè)-c <commit>洒嗤,等價(jià)于--reedit-message=<commit>,還有個(gè)差不多的-C <commit>魁亦,等價(jià)于--reuse-message=<commit>渔隶。這種做法會(huì)重用<commit>的message,將其原封不動(dòng)地利用起來(lái)洁奈,只要是當(dāng)前git中已經(jīng)存在的commit就可以间唉,不存在的話(huà)可以先從其他地方fetch過(guò)來(lái)绞灼。-c,reedit呈野,會(huì)啟動(dòng)文本編輯器镀赌,讓用戶(hù)可以重新編輯;-C际跪,reuse,不給用戶(hù)重新編輯的機(jī)會(huì)喉钢,相當(dāng)于-c <commit> --no-edit姆打。重用是很方便,但這種做法不僅僅重用了message肠虽,連author和date也一起重用了幔戏,除了commit id不一樣,其他都一樣税课,一看就是抄來(lái)的闲延。所以我們最好再加上--reset-author參數(shù),這么做會(huì)使用當(dāng)前的author和date韩玩。
git commit -c HEAD --reset-author
4. git commit還提供了從文件中讀取message的方法垒玲,-F <file>,等價(jià)于--file=<file>找颓。這不會(huì)啟動(dòng)文本編輯器合愈,直接將<file>中的內(nèi)容全部拿過(guò)來(lái)當(dāng)作message,包括以#開(kāi)頭的行击狮。本來(lái).git/COMMIT_EDITMSG中以#開(kāi)頭的行都算是注釋?zhuān)粫?huì)被添加到message中去的佛析。這時(shí)我們?cè)儆胓it commit --amend,什么都不改彪蓬,保存退出的話(huà)寸莫,那么以#開(kāi)頭的內(nèi)容就都從message中消失了。<file>可以是標(biāo)準(zhǔn)輸入档冬,用“-”來(lái)表示膘茎。譬如echo "hello world" | git commit -F -。
echo "hello world" > hw && git commit -F hw
5. git commit中并沒(méi)有像-c和-C那樣提供一個(gè)-f <file>來(lái)讓用戶(hù)reedit這個(gè)file捣郊,而是用了-t <file>辽狈,等價(jià)于--template=<file>。這會(huì)啟動(dòng)文本編輯器呛牲,已有的內(nèi)容是<file>中的內(nèi)容刮萌,用戶(hù)可以進(jìn)行編輯之后保存退出。用戶(hù)如果沒(méi)有做什么修改的話(huà)娘扩,或者修改完后內(nèi)容沒(méi)變的話(huà)着茸,commit不會(huì)成功壮锻。如果想要偷懶一點(diǎn)的話(huà),可以用git config設(shè)置下commit.template涮阔,給其指定這個(gè)template file猜绣,指定完以后就不用每次都輸入-t <file>了。如果用了-c敬特,-C或者-F的話(huà)掰邢,那么-t <file>和commit.template是不會(huì)起作用的。template的方式比較適合用于事先約定好message格式的場(chǎng)景伟阔,把格式的固定內(nèi)容都放在template中辣之,用戶(hù)commit的時(shí)候把其余部分填寫(xiě)完整就可以了。
echo "hello world" > hwt && git commit -t hwt
6. 如果懶得什么message都不想寫(xiě)皱炉!那用--allow-empty-message就可以了怀估,但你確定要這么做嗎?
echo "I am a git" && git commit --allow-empty-message --no-edit
7. 如果你拒絕使用--allow-empty-message合搅,但又不想寫(xiě)commit log message的話(huà)多搀,那就安靜地做個(gè)integrator吧。用git merge灾部,git rebase康铭,git cherry-pick,git am梳猪,都是體貼你的小棉襖麻削,但一定要拒絕git apply,因?yàn)樗鼤?huì)要你寫(xiě)message的春弥。
8. 親手試一下每種方式吧呛哟!如果覺(jué)得每次要做點(diǎn)修改或者新增個(gè)文件才能add、commit很麻煩的話(huà)匿沛,那就加上--allow-empty吧扫责,什么文件都不用改,也不用git add逃呼,直接就可以commit了鳖孤!如果不想在嘗試的時(shí)候生成一長(zhǎng)串無(wú)用的commit的話(huà),那在有root commit的情況下再加上個(gè)--amend吧抡笼,改來(lái)改去都只有一個(gè)commit苏揣。
echo "I love git" && git commit --allow-empty --amend