.gitignore忽略規則、語法、檢查檔案詳解
阿新 • • 發佈:2018-12-15
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行規則忽略了該檔案,於是我們就可以知道應該修訂哪個規則。