忽略文件
一般我們總會有些文件無需納入 Git 的管理,也不希望它們總出現(xiàn)在未跟蹤文件列表。 通常都是些自動生成的文件,比如日志文件,或者編譯過程中創(chuàng)建的臨時文件等。 在這種情況下,我們可以創(chuàng)建一個名為 .gitignore
的文件,列出要忽略的文件模式。 來看一個實際的例子:
$ cat .gitignore
*.[oa]
*~
第一行告訴 Git 忽略所有以 .o 或 .a 結(jié)尾的文件。一般這類對象文件和存檔文件都是編譯過程中出現(xiàn)的。 第二行告訴 Git 忽略所有以波浪符(~)結(jié)尾的文件,許多文本編輯軟件(比如 Emacs)都用這樣的文件名保存副本。 此外,你可能還需要忽略 log,tmp 或者 pid 目錄,以及自動生成的文檔等等。 要養(yǎng)成一開始就設置好 .gitignore 文件的習慣,以免將來誤提交這類無用的文件。
文件 .gitignore 的格式規(guī)范如下:
所有空行或者以 # 開頭的行都會被 Git 忽略。
可以使用標準的 glob 模式匹配。
匹配模式可以以(/)開頭防止遞歸。
匹配模式可以以(/)結(jié)尾指定目錄。
要忽略指定模式以外的文件或目錄,可以在模式前加上驚嘆號(!)取反。
所謂的 glob 模式是指 shell 所使用的簡化了的正則表達式。 星號()匹配零個或多個任意字符;[abc] 匹配任何一個列在方括號中的字符(這個例子要么匹配一個 a,要么匹配一個 b,要么匹配一個 c);問號(?)只匹配一個任意字符;如果在方括號中使用短劃線分隔兩個字符,表示所有在這兩個字符范圍內(nèi)的都可以匹配(比如 [0-9] 表示匹配所有 0 到 9 的數(shù)字)。 使用兩個星號() 表示匹配任意中間目錄,比如a/**/z
可以匹配 a/z
, a/b/z
或 a/b/c/z
等。
我們再看一個 .gitignore 文件的例子:
# 忽略所有的.a 文件
*.a
# 不忽略lib.a,雖然在上面已經(jīng)忽略了所有的.a文件
!lib.a
# 只忽略當前文件夾下的TODO文件,而不是整個文件夾中的文件
/TODO
# 忽略 build/ 文件夾下所有文件
build/
# 會忽略掉 doc/notes.txt, 但不會忽略掉 doc/server/arch.txt
doc/*.txt
# 忽略所有 doc/ 文件夾下的pdf文件
doc/**/*.pdf
Tip:
GitHub 有一個十分詳細的針對數(shù)十種項目及語言的 .gitignore文件列表,你可以在 [https://github.com/github/gitignore(https://github.com/github/gitignore) 找到它.