1. 程式人生 > >.gitignore忽略規則、語法、檢查檔案詳解

.gitignore忽略規則、語法、檢查檔案詳解

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行規則忽略了該檔案,於是我們就可以知道應該修訂哪個規則。