# git .gitignore 文件的忽略规则
# 注释 .gitignore 以中 ‘#’ 开头作为注释
# 忽略所有.txt 后缀的文件
.txt
# 忽略除 src.a 外的其他文件
!src.a
# 仅忽略项目根目录下的 todo 文件,不包括 src/todo
/todo
# 忽略 build/ 目录下的所有文件,过滤整个 build 文件夹
build/
# 忽略 doc 目录下所有 .txt 后缀的文件,但不包括 doc 子目录中的.txt 文件
doc/*.txt
# 忽略当前路径下的 bin 文件夹,该文件夹下的所有内容都会被忽略,不忽略 bin 文件
bin/
# 忽略根目录下的 bin 文件
/bin
# 忽略 cat.c,不忽略 build/cat.c
/*.c
# 忽略 debug/io.obj,不忽略 debug/common/io.obj 和 tools/debug/io.obj
debug/*.obj
# 忽略 /foo, a/foo, a/b/foo 等
**/foo
# 忽略 a/b, a/x/b, a/x/y/b 等
a/**/b
# 不忽略 bin 目录下的 run.sh 文件
!/bin/run.sh
# 忽略所有 .log 文件
*.log
# 忽略当前路径的 config.js 文件
config.js
# 忽略整个文件夹
/mtk/
# 忽略所有.zip 文件
*.zip
# 忽略某个具体文件
/mtk/do.c
# 注意
被过滤掉的文件就不会出现在 git 仓库中(gitlab 或 github)了,当然本地库中还有,只是 push 的时候不会上传。
2、语法解释
在 .gitignore 文件中,每一行的忽略规则的语法如下:
1)空格不匹配任意文件,可作为分隔符,可用反斜杠转义;
2)以 “#” 开头的行都会被 Git 忽略。即 #开头的文件标识注释,可以使用反斜杠进行转义;
3)可以使用标准的 glob 模式匹配。所谓的 glob 模式是指 shell 所使用的简化了的正则表达式;
4)以斜杠 “/” 开头表示目录;“/” 结束的模式只匹配该文件夹以及在该文件夹路径下的内容,但是不匹配该文件;"/" 开始的模式匹配项目跟目录;如果一个模式不包含斜杠,则它匹配相对于当前 .gitignore 文件路径的内容,如果该模式不在 .gitignore 文件中,则相对于项目根目录;
5)以星号 “*” 通配多个字符,即匹配多个任意字符;使用两个星号 “**” 表示匹配任意中间目录,比如 a/**/z
可以匹配 a/z, a/b/z 或 a/b/c/z 等;
6)以问号 "?" 通配单个字符,即匹配一个任意字符;
7)以方括号 “[] ” 包含单个字符的匹配列表,即匹配任何一个列在方括号中的字符。比如 [abc] 表示要么匹配一个 a,要么匹配一个 b,要么匹配一个 c;如果在方括号中使用短划线分隔两个字符,表示所有在这两个字符范围内的都可以匹配。比如 [0-9] 表示匹配所有 0 到 9 的数字,[a-z] 表示匹配任意的小写字母);
8)以叹号 "!" 表示不忽略 (跟踪) 匹配到的文件或目录,即要忽略指定模式以外的文件或目录,可以在模式前加上惊叹号(!)取反;