在使用Git的過程中荷腊,我們喜歡有的文件比如日志环凿,臨時文件,編譯的中間文件等不要提交到代碼倉庫,這時就要設置相應的忽略規(guī)則御毅,來忽略這些文件的提交根欧。
規(guī)則 作用
/mtk 過濾整個文件夾
*.zip 過濾所有.zip文件
/mtk/do.c 過濾某個具體文件
!/mtk/one.txt 追蹤(不過濾)某個具體文件
注意:如果你創(chuàng)建.gitignore文件之前就push了某一文件,那么即使你在.gitignore文件中寫入過濾該文件的規(guī)則端蛆,該規(guī)則也不會起作用凤粗,git仍然會對該文件進行版本管理。
配置語法
以斜杠“/”開頭表示目錄今豆;
以星號“*”通配多個字符嫌拣;
以問號“?”通配單個字符
以方括號“[]”包含單個字符的匹配列表;
以嘆號“!”表示不忽略(跟蹤)匹配到的文件或目錄呆躲。
注意: git 對于 .gitignore配置文件是按行從上到下進行規(guī)則匹配的
Git 忽略文件提交的方法
有三種方法可以實現(xiàn)忽略Git中不想提交的文件异逐。
在Git項目中定義 .gitignore 文件
這種方式通過在項目的某個文件夾下定義 .gitignore 文件,在該文件中定義相應的忽略規(guī)則插掂,來管理當前文件夾下的文件的Git提交行為灰瞻。
.gitignore 文件是可以提交到共有倉庫中,這就為該項目下的所有開發(fā)者都共享一套定義好的忽略規(guī)則辅甥。
在 .gitingore 文件中酝润,遵循相應的語法,在每一行指定一個忽略規(guī)則璃弄。如:
*.log
*.temp
/vendor
在Git項目的設置中指定排除文件
這種方式只是臨時指定該項目的行為要销,需要編輯當前項目下的 .git/info/exclude 文件,然后將需要忽略提交的文件寫入其中谢揪。
需要注意的是蕉陋,這種方式指定的忽略文件的根目錄是項目根目錄。
定義Git全局的 .gitignore 文件
除了可以在項目中定義 .gitignore 文件外拨扶,還可以設置全局的 git .gitignore 文件來管理所有Git項目的行為凳鬓。這種方式在不同的項目開發(fā)者之間是不共享的,是屬于項目之上Git應用級別的行為患民。
這種方式也需要創(chuàng)建相應的 .gitignore 文件缩举,可以放在任意位置。然后在使用以下命令配置Git:
git config --global core.excludesfile ~/.gitignore
Git 忽略規(guī)則
詳細的忽略規(guī)則可以參考官方英文文檔
Git 忽略規(guī)則優(yōu)先級
在 .gitingore 文件中匹颤,每一行指定一個忽略規(guī)則仅孩,Git 檢查忽略規(guī)則的時候有多個來源,它的優(yōu)先級如下(由高到低):
- 從命令行中讀取可用的忽略規(guī)則
- 當前目錄定義的規(guī)則
- 父級目錄定義的規(guī)則印蓖,依次地推
- $GIT_DIR/info/exclude 文件中定義的規(guī)則
- core.excludesfile中定義的全局規(guī)則
Git 忽略規(guī)則匹配語法
在 .gitignore 文件中辽慕,每一行的忽略規(guī)則的語法如下:
-
空格
不匹配任意文件,可作為分隔符赦肃,可用反斜杠轉(zhuǎn)義 -
# 開頭
的模式標識注釋溅蛉,可以使用反斜杠進行轉(zhuǎn)義 -
! 開頭
的模式標識否定公浪,該文件將會再次被包含,如果排除了該文件的父級目錄船侧,則使用 ! 也不會再次被包含欠气。可以使用反斜杠進行轉(zhuǎn)義 -
/ 結束
的模式只匹配文件夾以及在該文件夾路徑下的內(nèi)容镜撩,但是不匹配該文件 -
/ 開始
的模式匹配項目跟目錄 - 如果一個模式不包含斜杠预柒,則它匹配相對于當前 .gitignore 文件路徑的內(nèi)容,如果該模式不在 .gitignore 文件中袁梗,則相對于項目根目錄
-
**
匹配多級目錄宜鸯,可在開始,中間围段,結束 -
?
通用匹配單個字符 -
[]
通用匹配單個字符列表
常用匹配示例:
- bin/: 忽略當前路徑下的bin文件夾顾翼,該文件夾下的所有內(nèi)容都會被忽略,不忽略 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規(guī)則不生效
.gitignore只能忽略那些原來沒有被track的文件,如果某些文件已經(jīng)被納入了版本管理中涝桅,則修改.gitignore是無效的拜姿。
解決方法就是先把本地緩存刪除(改變成未track狀態(tài)),然后再提交:
git rm -r --cached .
git add .
git commit -m 'update .gitignore'