一般我們總會有些檔案無需納入 Git 的管理,也不希望它們總出現在未追蹤檔案列表。通常都是些自動產生的檔案,比如記錄檔,或者編譯過程中建立的臨時檔案等。我們可以建立一個名為 .gitignore 的檔案,列出要忽略的檔案模式。來看一個實際的例子:
$ cat .gitignore*.[oa]*~
第一行告訴 Git 忽略所有以 .o 或 .a 結尾的檔案。一般這類對象檔案和封存檔案都是編譯過程中出現的,我們用不著跟蹤它們的版本。第二行告訴 Git 忽略所有以波浪符(~)結尾的檔案,許多文本編輯軟體(比如
Emacs)都用這樣的檔案名稱儲存副本。此外,你可能還需要忽略 log,tmp 或者 pid 目錄,以及自動產生的文檔等等。要養成一開始就設定好 .gitignore 檔案的習慣,以免將來誤提交這類無用的檔案。
檔案 .gitignore 的格式規範如下:
- 所有空行或者以注釋符號 # 開頭的行都會被 Git 忽略。
- 可以使用標準的 glob 模式比對。
- 匹配模式最後跟反斜線(
/)說明要忽略的是目錄。
- 要忽略指定模式以外的檔案或目錄,可以在模式前加上驚歎號(
!)取反。
所謂的 glob 模式是指 shell 所使用的簡化了的Regex。星號(*)匹配零個或多個任一字元;[abc] 匹配任何一個列在方括弧中的字元(這個例子要麼匹配一個
a,要麼匹配一個 b,要麼匹配一個 c);問號(?)只匹配一個任一字元;如果在方括弧中使用短劃線分隔兩個字元,表示所有在這兩個字元範圍內的都可以匹配(比如 [0-9] 表示匹配所有
0 到 9 的數字)。
我們再看一個 .gitignore 檔案的例子:
# 此為注釋 – 將被 Git 忽略*.a # 忽略所有 .a 結尾的檔案!lib.a # 但 lib.a 除外/TODO # 僅僅忽略項目根目錄下的 TODO 檔案,不包括 subdir/TODObuild/ # 忽略 build/ 目錄下的所有檔案doc/*.txt # 會忽略 doc/notes.txt 但不包括 doc/server/arch.txt