語法
1)空格不匹配任意文件,可作為分隔符,可用反斜杠轉義
2)以“#”開頭的行都會被 Git 忽略。即#開頭的文件標識注釋,可以使用反斜杠進行轉義。
3)可以使用標准的glob模式匹配。所謂的glob模式是指shell所使用的簡化了的正則表達式。
4)以斜杠"/"開頭表示目錄;"/"結束的模式只匹配文件夾以及在該文件夾路徑下的內容,但是不匹配該文件;"/"開始的模式匹配項目跟目錄;如果一個模式不包含斜杠,則它匹配相對於當前 .gitignore 文件路徑的內容,如果該模式不在 .gitignore 文件中,則相對於項目根目錄。
5)以星號"*"通配多個字符,即匹配多個任意字符;使用兩個星號"**" 表示匹配任意中間目錄,比如`a/**/z`可以匹配 a/z, a/b/z 或 a/b/c/z等。
6)以問號"?"通配單個字符,即匹配一個任意字符;
7)以方括號"[]"包含單個字符的匹配列表,即匹配任何一個列在方括號中的字符。比如[abc]表示要么匹配一個a,要么匹配一個b,要么匹配一個c;如果在方括號中使用短划線分隔兩個字符,表示所有在這兩個字符范圍內的都可以匹配。比如[0-9]表示匹配所有0到9的數字,[a-z]表示匹配任意的小寫字母)。
8)以嘆號"!"表示不忽略(跟蹤)匹配到的文件或目錄,即要忽略指定模式以外的文件或目錄,可以在模式前加上驚嘆號(!)取反。需要特別注意的是:如果文件的父目錄已經被前面的規則排除掉了,那么對這個文件用"!"規則是不起作用的。也就是說"!"開頭的模式表示否定,該文件將會再次被包含,如果排除了該文件的父級目錄,則使用"!"也不會再次被包含。可以使用反斜杠進行轉義。
優先級
1)從命令行中讀取可用的忽略規則
2)當前目錄定義的規則
3)父級目錄定義的規則,依次遞推
4)$GIT_DIR/info/exclude 文件中定義的規則
5)core.excludesfile中定義的全局規則
常用匹配示例
# 表示此為注釋,將被Git忽略 *.a 表示忽略所有 .a 結尾的文件 !lib.a 表示但lib.a除外 /TODO 表示僅僅忽略項目根目錄下的 TODO 文件,不包括 subdir/TODO build/ 表示忽略 build/目錄下的所有文件,過濾整個build文件夾; doc/*.txt 表示會忽略doc/notes.txt但不包括 doc/server/arch.txt bin/: 表示忽略當前路徑下的bin文件夾,該文件夾下的所有內容都會被忽略,不忽略 bin 文件 /bin: 表示忽略根目錄下的bin文件 /*.c: 表示忽略cat.c,不忽略 build/cat.c debug/*.obj: 表示忽略debug/io.obj,不忽略 debug/common/io.obj和tools/debug/io.obj **/foo: 表示忽略/foo,a/foo,a/b/foo等 a/**/b: 表示忽略a/b, a/x/b,a/x/y/b等 !/bin/run.sh 表示不忽略bin目錄下的run.sh文件 *.log: 表示忽略所有 .log 文件 config.php: 表示忽略當前路徑的 config.php 文件 /mtk/ 表示過濾整個文件夾 *.zip 表示過濾所有.zip文件 /mtk/do.c 表示過濾某個具體文件 被過濾掉的文件就不會出現在git倉庫中(gitlab或github)了,當然本地庫中還有,只是push的時候不會上傳。 需要注意的是,gitignore還可以指定要將哪些文件添加到版本管理中,如下: !*.zip !/mtk/one.txt 唯一的區別就是規則開頭多了一個感嘆號,Git會將滿足這類規則的文件添加到版本管理中。為什么要有兩種規則呢? 想象一個場景:假如我們只需要管理/mtk/目錄中的one.txt文件,這個目錄中的其他文件都不需要管理,那么.gitignore規則應寫為:: /mtk/* !/mtk/one.txt 假設我們只有過濾規則,而沒有添加規則,那么我們就需要把/mtk/目錄下除了one.txt以外的所有文件都寫出來! 注意上面的/mtk/*不能寫為/mtk/,否則父目錄被前面的規則排除掉了,one.txt文件雖然加了!過濾規則,也不會生效! ---------------------------------------------------------------------------------- 還有一些規則如下: fd1/* 說明:忽略目錄 fd1 下的全部內容;注意,不管是根目錄下的 /fd1/ 目錄,還是某個子目錄 /child/fd1/ 目錄,都會被忽略; /fd1/* 說明:忽略根目錄下的 /fd1/ 目錄的全部內容; /* !.gitignore !/fw/ /fw/* !/fw/bin/ !/fw/sf/ 說明:忽略全部內容,但是不忽略 .gitignore 文件、根目錄下的 /fw/bin/ 和 /fw/sf/ 目錄;注意要先對bin/的父目錄使用!規則,使其不被排除。
.gitignore規則不生效
.gitignore只忽略那些沒有被track的文件,如果文件已經被納入了版本管理中,則修改.gitignore是無效的。
解決方法就是先把本地緩存刪除(改變成未track狀態),然后再提交:
[root@zhang~]# git rm -r --cached . [root@zhang~]# git add . [root@zhang~]# git commit -m 'update .gitignore' [root@zhang~]# git push -u origin master
強制添加一個文件到版本控制中
[root@zhang~]# git add -f App.class
轉自:Git忽略提交規則 - .gitignore配置運維總結