一般我们总会有些文件无需纳入 Git
的管理,也不希望它们总出现在未跟踪文件列表。通常都是些自动生成的文件,比如日志文件,或者编译过程中创建的临时文件等。我们可以创建一个名为 .gitignore
的文件,列出要忽略的文件模式。来看一个实际的例子:
$ cat .gitignore *.[oa] *~
第一行告诉 Git
忽略所有以 .o 或 .a 结尾的文件。一般这类对象文件和存档文件都是编译过程中出现的,我们用不着跟踪它们的版本。第二行告诉 Git
忽略所有以波浪符(~)结尾的文件,许多文本编辑软件(比如 Emacs)都用这样的文件名保存副本。此外,你可能还需要忽略
log,tmp 或者 pid 目录,以及自动生成的文档等等。要养成一开始就设置好 .gitignore
文件的习惯,以免将来误提交这类无用的文件。
文件.gitignore
的格式规范如下:
●所有空行或者以注释符号 # 开头的行都会被 Git
忽略。
● 可以使用标准的 glob
模式匹配。 * 匹配模式最后跟反斜杠(/)说明要忽略的是目录。 *
要忽略指定模式以外的文件或目录,可以在模式前加上惊叹号(!)取反。
所谓的glob
模式是指 shell 所使用的简化了的正则表达式。星号(*)匹配零个或多个任意字符;[abc] 匹配任何一个列在方括号中的字符(这个例子要么匹配一个 a,要么匹配一个 b,要么匹配一个 c);问号(?)只匹配一个任意字符;如果在方括号中使用短划线分隔两个字符,表示所有在这两个字符范围内的都可以匹配(比如[0-9] 表示匹配所有
0 到 9 的数字)。
我们再看一个 .gitignore
文件的例子:
#
此为注释 – 将被 Git 忽略
*.a #
忽略所有 .a 结尾的文件
!lib.a #
但 lib.a 除外
/TODO #
仅仅忽略项目根目录下的 TODO 文件,不包括 subdir/TODO
build/ #
忽略 build/ 目录下的所有文件
doc/*.txt #
会忽略doc/notes.txt 但不包括 doc/server/arch.txt