.gitignore文件作用及使用方法詳解

Posted on by

正文

在本地的代碼目錄中，有些文件或者目錄我們並不想提交到倉庫中，比如一些運行日志等文件。這樣的話，我們提交代碼時，就隻能一個一個文件去git add，太麻煩瞭。

為瞭解決這個問題，Git裡面有一個.gitignore文件。可以指定Git需要忽略哪些文件。配置好之後，Git就會自動忽略滿足配置的文件。這樣，我們就可以盡情的使用git add .來添加文件瞭。

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的忽略的話。忽略是不會生效的，需要我們手動先將緩存刪除。

# 刪除本地的緩存
git rm -r --cached .
# 重新提交
git commit -am 'gitignore'

添加一個已經配置忽略的文件

再比如，我們忽略瞭文件夾A，但是現在要往文件夾A中添加代碼文件。你會發現你沒法把文件夾A中的代碼提交。因為文件夾A被忽略瞭。

# 強制添加
git add -f 文件A/xxx.js
# 正常提交
git commit -am 'xxx'

檢查文件為什麼被忽略

由於.gitignore文件經常會配置很多內容，某些文件你並不能很直觀的知道為什麼被忽略瞭。所以Git提供瞭一個檢查忽略的命令。

git check-ignore -v 文件夾A/xxx.js

gitignore建議

最後，提供一個網上整理的關於不同開發語言項目的.gitignore文件內容的建議：github.com/github/giti…

以上就是.gitignore文件作用及使用方法詳解的詳細內容，更多關於.gitignore文件的資料請關註WalkonNet其它相關文章！

推薦閱讀：