如何忽略Git中目录中的文件？

Question

.gitignore忽略目录中文件的文件的正确语法是什么？

可不可能是

config/databases.yml
cache/*
log/*
data/sql/*
lib/filter/base/*
lib/form/base/*
lib/model/map/*
lib/model/om/*

要么

/config/databases.yml
/cache/*
/log/*
/data/sql/*
/lib/filter/base/*
/lib/form/base/*
/lib/model/map/*
/lib/model/om/*

？

Answer 1

模式格式

• 空行不匹配任何文件,因此它可以作为可读性的分隔符.

• 以开头的行#作为注释.

• 一个!否定模式的可选前缀; 之前模式排除的任何匹配文件将再次包含在内.如果否定模式匹配,则将覆盖较低优先级模式源.

• 如果模式以斜杠结尾,则为了以下描述的目的将其删除,但它只会找到与目录的匹配项.换句话说,foo/将匹配foo它下面的目录和路径,但不匹配常规文件或符号链接foo(这与在git中一般使用pathspec的方式一致).

• 如果模式不包含斜杠/,git会将其视为shell glob模式,并检查相对于.gitignore文件位置的路径名的匹配(相对于工作树的顶层,如果不是来自.gitignore文件).

• 否则,git将模式视为适合使用的shell glob,fnmatch(3)并带有FNM_PATHNAME标志:模式中的通配符/与路径名中的a不匹配.例如,Documentation/*.html匹配Documentation/git.html但不是Documentation/ppc/ppc.html或tools/perf/Documentation/perf.html.

• 前导斜杠与路径名的开头匹配.例如,/*.c匹配cat-file.c但不匹配mozilla-sha1/sha1.c.

你可以在这里找到更多

git help gitignore
要么
man gitignore

Answer 2

这将是前者.也可以通过扩展而不是文件夹结构.

即我的示例C#development忽略文件:

#OS junk files
[Tt]humbs.db
*.DS_Store

#Visual Studio files
*.[Oo]bj
*.user
*.aps
*.pch
*.vspscc
*.vssscc
*_i.c
*_p.c
*.ncb
*.suo
*.tlb
*.tlh
*.bak
*.[Cc]ache
*.ilk
*.log
*.lib
*.sbr
*.sdf
ipch/
obj/
[Bb]in
[Dd]ebug*/
[Rr]elease*/
Ankh.NoLoad

#Tooling
_ReSharper*/
*.resharper
[Tt]est[Rr]esult*

#Project files
[Bb]uild/

#Subversion files
.svn

# Office Temp Files
~$*

更新

我想我会从下面的评论中提供更新.虽然没有直接回答OP的问题,但请参阅以下内容以获取更多.gitignore语法示例.

社区维基(不断更新):

.gitignore for Visual Studio项目和解决方案

可以在这里找到更多具有特定语言用法的例子(感谢Chris McKnight的评论):

https://github.com/github/gitignore

Answer 3

包含斜杠的路径被认为是相对于包含.gitignore文件的目录 - 通常是存储库的顶层,但您也可以将它们放在子目录中.

所以,因为在你提供的所有例子中,路径都包含斜杠,两个版本是相同的.只有在路径中没有一个时,才需要设置一个前导斜杠.例如,要仅在存储库的顶级忽略foo,请使用/foo.简单地写入foo会忽略存储库中任何名为foo的内容.

你的通配符也是多余的.如果要忽略整个目录,只需将其命名为:

lib/model/om

使用通配符的唯一原因是,如果您打算随后忽略目录中的某些内容:

lib/model/om/*      # ignore everything in the directory
!lib/model/om/foo   # except foo

Answer 4

前导斜杠表示忽略条目仅对.gitignore文件所在的目录有效.指定*.o将忽略此目录和所有子目录中的所有.o文件,而/*.o只是忽略它们在那个目录中,同时再次/foo/*.o忽略它们在/foo/*.o中.

Answer 5

如果要将.gitignore文件放在顶层,并使其适用于下面使用的任何文件夹/**/.

例如,忽略*.map文件/src/main/夹和子文件夹中的所有文件使用:

/src/main/**/*.map

Answer 6

问题中的两个例子实际上是非常糟糕的例子,可能导致数据丢失!

我的建议:永远不要附加/*到.gitignore文件中的目录,除非你有充分的理由!

一个很好的理由是例如Jefromi写的:"如果你打算随后忽略目录中的某些东西".

不应该这样做的原因是,追加/*到目录一方面是以正确忽略目录的所有内容的方式工作,但另一方面它具有危险的副作用:

如果您在git stash -u存储库中执行(临时存储已跟踪和未跟踪的文件)或git clean -df(删除未跟踪但保留被忽略的文件),/*则会不可逆转地删除所有被追加的目录!

一些背景

我必须以艰难的方式学习这一点.我的团队中有人在/*我们的.gitignore中添加了一些目录.随着时间的推移,某些目录会突然消失.我们的应用程序需要具有千兆字节本地数据的目录.没有人可以解释它,我总是重新下载所有数据.过了一会儿,我得到了一个可能与之有关的想法git stash.有一天,我想清理我的本地仓库(同时保持被忽略的文件),我正在使用git clean -df,我的数据再次消失了.这次我受够了并调查了这个问题.我终于想到了原因是附加的/*.

我认为可以通过directory/*忽略目录的所有内容但不忽略目录本身的事实来解释它.因此,当事情被删除时,它既不被视为被跟踪也不被忽略.尽管如此,git status并git status --ignored给它略有不同的画面.

如何重现

以下是如何重现行为.我目前正在使用Git 2.8.4.

所谓的目录localdata/,在它的虚拟文件(important.dat)将在本地的Git仓库被创建和内容将通过将被忽略/localdata/*到.gitignore文件中.当现在执行两个提到的git命令之一时,该目录将(意外地)丢失.

mkdir test
cd test
git init
echo "/localdata/*" >.gitignore
git add .gitignore
git commit -m "Add .gitignore."
mkdir localdata
echo "Important data" >localdata/important.dat
touch untracked-file

如果你在git status --ignored这里做,你会得到:

On branch master
Untracked files:
  (use "git add <file>..." to include in what will be committed)

  untracked-file

Ignored files:
  (use "git add -f <file>..." to include in what will be committed)

  localdata/

现在要么做

git stash -u
git stash pop

要么

git clean -df

在这两种情况下,据称被忽略的目录localdata都将消失!

不确定这是否可以被视为一个错误,但我想这至少是一个没人需要的功能.

我将把它报告给git开发列表,看看他们对它的看法.

Answer 7

这将是:

config/databases.yml
cache
log
data/sql
lib/filter/base
lib/form/base
lib/model/map
lib/model/om

甚至可能:

config/databases.yml
cache
log
data/sql
lib/*/base
lib/model/map
lib/model/om

如果是filter并且form是lib中唯一具有base需要忽略的子目录的目录(请参阅它作为您可以使用星号进行操作的示例).

Answer 8

第一个.这些文件路径与.gitignore文件的位置相对.