Git 忽略規則優先級
在 .gitingore 檔案中,每一行指定一個忽略規則,Git 檢查忽略規則的時候有多個來源,它的優先級如下(由高到低):
從指令行中讀取可用的忽略規則
目前目錄定義的規則
父級目錄定義的規則,依次遞推
$GIT_DIR/info/exclude 檔案中定義的規則
core.excludesfile中定義的全局規則
Git 忽略規則比對文法
在 .gitignore 檔案中,每一行的忽略規則的文法如下:
空格不比對任意檔案,可作為分隔符,可用反斜杠轉義
開頭的檔案辨別注釋,可以使用反斜杠進行轉義
! 開頭的模式辨別否定,該檔案将會再次被包含,如果排除了該檔案的父級目錄,則使用 ! 也不會再次被包含。可以使用反斜杠進行轉義
/ 結束的模式隻比對檔案夾以及在該檔案夾路徑下的内容,但是不比對該檔案
/ 開始的模式比對項目跟目錄
如果一個模式不包含斜杠,則它比對相對于目前 .gitignore 檔案路徑的内容,如果該模式不在 .gitignore 檔案中,則相對于項目根目錄
** 比對多級目錄,可在開始,中間,結束
? 通用比對單個字元
[] 通用比對單個字元清單
常用比對示例:
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 檔案
.gitignore規則不生效
.gitignore隻能忽略那些原來沒有被track的檔案,如果某些檔案已經被納入了版本管理中,則修改.gitignore是無效的。
解決方法就是先把本地緩存删除(改變成未track狀态),然後再送出:
git rm -r --cached .
git add .
git commit -m 'update .gitignore'
你想添加一個檔案到Git,但發現添加不了,原因是這個檔案被.gitignore忽略了:
$ git add App.class
The following paths are ignored by one of your .gitignore files:
App.class
Use -f if you really want to add them.
如果你确實想添加該檔案,可以用-f強制添加到Git:
$ git add -f App.class
或者你發現,可能是.gitignore寫得有問題,需要找出來到底哪個規則寫錯了,可以用git check-ignore指令檢查:
$ git check-ignore -v App.class
.gitignore:3:*.class App.class
Git會告訴我們,.gitignore的第3行規則忽略了該檔案,于是我們就可以知道應該修訂哪個規則。