通常来讲,咱们总会遇到有些文件无需归入 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 文件的例子:
# 忽略全部 .a 结尾的文件
*.a
# 但 lib.a 除外
!lib.a
# 仅仅忽略项目根目录下的 TODO 文件,不包括 subdir/TODO
/TODO
# 忽略 build/ 目录下的全部文件
build/
# 会忽略 doc/notes.txt 但不包括 doc/server/arch.txt
doc/*.txt
其余信息能够直接 man gitignore 查看。