對(duì)于經(jīng)常使用Git的朋友來(lái)說(shuō),.gitignore配置一定不會(huì)陌生。廢話不說(shuō)多了,接下來(lái)就來(lái)說(shuō)說(shuō)這個(gè).gitignore的使用。
首先要強(qiáng)調(diào)一點(diǎn),這個(gè)文件的完整文件名就是".gitignore",注意最前面有個(gè)“.”。
一般來(lái)說(shuō)每個(gè)Git項(xiàng)目中都需要一個(gè)“.gitignore”文件,這個(gè)文件的作用就是告訴Git哪些文件不需要添加到版本管理中。實(shí)際項(xiàng)目中,很多文件都是不需要版本管理的,比如Python的.pyc文件和一些包含密碼的配置文件等等。這個(gè)文件的內(nèi)容是一些規(guī)則,Git會(huì)根據(jù)這些規(guī)則來(lái)判斷是否將文件添加到版本控制中。
下面我們看看常用的規(guī)則:
1)/mtk/過(guò)濾整個(gè)文件夾
2)*.zip過(guò)濾所有.zip文件
3)/mtk/do.c過(guò)濾某個(gè)具體文件
很簡(jiǎn)單吧,被過(guò)濾掉的文件就不會(huì)出現(xiàn)在git倉(cāng)庫(kù)中(gitlab或github)了,當(dāng)然本地庫(kù)中還有,只是push的時(shí)候不會(huì)上傳。
需要注意的是,gitignore還可以指定要將哪些文件添加到版本管理中:
1)!*.zip
2)!/mtk/one.txt
唯一的區(qū)別就是規(guī)則開(kāi)頭多了一個(gè)感嘆號(hào),Git會(huì)將滿足這類(lèi)規(guī)則的文件添加到版本管理中。
為什么要有兩種規(guī)則呢?想象一個(gè)場(chǎng)景:假如我們只需要管理/mtk/目錄中的one.txt文件,這個(gè)目錄中的其他文件都不需要管理,那么我們就需要使用:
1)/mtk/
2)!/mtk/one.txt
假設(shè)我們只有過(guò)濾規(guī)則,而沒(méi)有添加規(guī)則,那么我們就需要把/mtk/目錄下除了one.txt以外的所有文件都寫(xiě)出來(lái)!
最后需要強(qiáng)調(diào)的一點(diǎn)是,如果你不慎在創(chuàng)建.gitignore文件之前就push了項(xiàng)目,那么即使你在.gitignore文件中寫(xiě)入新的過(guò)濾規(guī)則,這些規(guī)則也不會(huì)起作用,Git仍然會(huì)對(duì)所有文件進(jìn)行版本管理。
簡(jiǎn)單來(lái)說(shuō),出現(xiàn)這種問(wèn)題的原因就是Git已經(jīng)開(kāi)始管理這些文件了,所以你無(wú)法再通過(guò)過(guò)濾規(guī)則過(guò)濾它們。因此一定要養(yǎng)成在項(xiàng)目開(kāi)始就創(chuàng)建.gitignore文件的習(xí)慣,否則一旦push,處理起來(lái)會(huì)非常麻煩。
.gitignore配置文件用于配置不需要加入版本管理的文件,配置好該文件可以為版本管理帶來(lái)很大的便利,以下是對(duì)于配置.gitignore的一些心得記錄:
1)配置語(yǔ)法:
以斜杠“/”開(kāi)頭表示目錄;
以星號(hào)“*”通配多個(gè)字符;
以問(wèn)號(hào)“?”通配單個(gè)字符
以方括號(hào)“[]”包含單個(gè)字符的匹配列表;
以嘆號(hào)“!”表示不忽略(跟蹤)匹配到的文件或目錄;
此外,git 對(duì)于 .ignore 配置文件是按行從上到下進(jìn)行規(guī)則匹配的,意味著如果前面的規(guī)則匹配的范圍更大,則后面的規(guī)則將不會(huì)生效;
2)示例說(shuō)明
a)規(guī)則:fd1/*
說(shuō)明:忽略目錄 fd1 下的全部?jī)?nèi)容;注意,不管是根目錄下的 /fd1/ 目錄,還是某個(gè)子目錄 /child/fd1/ 目錄,都會(huì)被忽略;
b)規(guī)則:/fd1/*
說(shuō)明:忽略根目錄下的 /fd1/ 目錄的全部?jī)?nèi)容;
c)規(guī)則:
/*
!.gitignore
!/fw/bin/
!/fw/sf/
說(shuō)明:忽略全部?jī)?nèi)容,但是不忽略 .gitignore 文件、根目錄下的 /fw/bin/ 和 /fw/sf/ 目錄;
-------------------------------------------------------------------------------------------------------------------
下面是線上使用過(guò)的一個(gè)gerrit里項(xiàng)目代碼的.gitignore的配置(在項(xiàng)目中添加.gitignore過(guò)濾文件,在git push到gerrit里即可)
---------------------------------------------------------------------------------------------------
其實(shí),需要清除的一點(diǎn)是:
有三種方法可以實(shí)現(xiàn)過(guò)濾掉Git里不想上傳的文件,這三種方法都能達(dá)到目的,只不過(guò)適用情景不一樣。
1)第一種方法
針對(duì)單一工程排除文件,這種方式會(huì)讓這個(gè)工程的所有修改者在克隆代碼的同時(shí),也能克隆到過(guò)濾規(guī)則,而不用自己再寫(xiě)一份,這就能保證所有修改者應(yīng)用的都是同一份規(guī)則,而不是張三自己有一套過(guò)濾規(guī)則,李四又使用另一套過(guò)濾規(guī)則,個(gè)人比較喜歡這個(gè)。配置步驟如下:
在工程根目錄下建立.gitignore文件,將要排除的文件或目錄 寫(xiě)到.gitignore這個(gè)文件中,其中有兩種寫(xiě)入方法。
a)使用命令行增加排除文件
排除以.class結(jié)尾的文件 echo “*.class” >.gitignore (>> 是在文件尾增加,> 是刪除已經(jīng)存在的內(nèi)容再增加),之后會(huì)在當(dāng)前目錄下生成一個(gè).gitignore的文件。
排除bin目錄下的文件 echo “bin/” >.gitignore
b)最方便的辦法是,用記事本打開(kāi),增加需要排除的文件或目錄,一行增加一個(gè),例如:
1
2
3
4
5
6*.class
*.apk
bin/
gen/
.settings/
proguard/
2)第二種方法
全局設(shè)置排除文件,這會(huì)在全局起作用,只要是Git管理的工程,在提交時(shí)都會(huì)自動(dòng)排除不在控制范圍內(nèi)的文件或目錄。這種方法對(duì)開(kāi)發(fā)者來(lái)說(shuō),比較省事,只要一次全局配置,不用每次建立工程都要配置一遍過(guò)濾規(guī)則。但是這不保證其他的開(kāi)發(fā)者在克隆你的代碼后,他們那邊的規(guī)則跟你的是一樣的,這就帶來(lái)了代碼提交過(guò)程中的各種沖突問(wèn)題。
配置步驟如下:
a)像方法(1)一樣,也需要建立一個(gè).gitignore文件,把要排除的文件寫(xiě)進(jìn)去。
b)但在這里,我們不規(guī)定一定要把.gitnore文件放到某個(gè)工程下面,而是任何地方,比如我們這里放到了Git默認(rèn)的Home路徑下,比如:/home/wangshibo/hqsb_ios
c)使用命令方式可以配置全局排除文件 git config --global core.excludesfile ~/.gitignore,你會(huì)發(fā)現(xiàn)在~/.gitconfig文件中會(huì)出現(xiàn)excludesfile = /home/wangshibo/hqsb_ios/.gitignore。
說(shuō)明Git把文件過(guò)濾規(guī)則應(yīng)用到了Global的規(guī)則中。
3)第三種方法
單個(gè)工程設(shè)置排除文件,在工程目錄下找到.git/info/exclude,把要排除的文件寫(xiě)進(jìn)去:
1
2
3
4
5
6*.class
*.apk
bin/
gen/
.settings/
proguard/
這種方法就不提倡了,只能針對(duì)單一工程配置,而且還不能將過(guò)濾規(guī)則同步到其他開(kāi)發(fā)者,跟方法(1)(2)比較起來(lái)沒(méi)有一點(diǎn)優(yōu)勢(shì)。
------------------------Git忽略規(guī)則及.gitignore規(guī)則不生效的解決辦法-----------------------------
在git中如果想忽略掉某個(gè)文件,不讓這個(gè)文件提交到版本庫(kù)中,可以使用修改根目錄中 .gitignore 文件的方法(如無(wú),則需自己手工建立此文件)。這個(gè)文件每一行保存了一個(gè)匹配的規(guī)則例如:
# 此為注釋 – 將被 Git 忽略
*.a # 忽略所有 .a 結(jié)尾的文件
!lib.a # 但 lib.a 除外
/TODO # 僅僅忽略項(xiàng)目根目錄下的 TODO 文件,不包括 subdir/TODO
build/ # 忽略 build/ 目錄下的所有文件
doc/*.txt # 會(huì)忽略 doc/notes.txt 但不包括 doc/server/arch.txt
規(guī)則很簡(jiǎn)單,不做過(guò)多解釋?zhuān)怯袝r(shí)候在項(xiàng)目開(kāi)發(fā)過(guò)程中,突然心血來(lái)潮想把某些目錄或文件加入忽略規(guī)則,按照上述方法定義后發(fā)現(xiàn)并未生效,原因是.gitignore只能忽略那些原來(lái)沒(méi)有被track的文件,如果某些文件已經(jīng)被納入了版本管理中,則修改.gitignore是無(wú)效的。那么解決方法就是先把本地緩存刪除(改變成未track狀態(tài)),然后再提交:
git rm -r --cached .
git add .
git commit -m 'update .gitignore'
注意:
不要誤解了 .gitignore 文件的用途,該文件只能作用于 Untracked Files,也就是那些從來(lái)沒(méi)有被 Git 記錄過(guò)的文件(自添加以后,從未 add 及 commit 過(guò)的文件)。
如果文件曾經(jīng)被 Git 記錄過(guò),那么.gitignore 就對(duì)它們完全無(wú)效。
***************當(dāng)你發(fā)現(xiàn)自己的才華撐不起野心時(shí),就請(qǐng)安靜下來(lái)學(xué)習(xí)吧***************