Gitignore忽略指定子目录及内容的正确写法与差异解析

我测试了四种在.gitignore中排除指定子目录hey及其所有内容的写法，测试结构为hey目录下包含文件a、ab，以及子目录abc（内有文件a），并通过git check-ignore -v验证了匹配效果：

• 仅目录名：hey
• 带斜杠的目录名：hey/
• 单星匹配：hey/*
• 双星匹配：hey/**

1. hey/*与hey/**的场景差异 #

hey/*仅匹配hey目录下的直接子项（包括直接文件和一级子目录），但不会匹配子目录里的深层内容。比如它能匹配hey/a、hey/abc，但不会匹配hey/abc/a——如果只写hey/*，hey/abc/a不会被忽略，除非abc目录本身被规则匹配后间接触发忽略。
hey/**则会匹配hey目录下所有层级的内容，不管是直接文件还是嵌套多少层的子目录和文件，比如hey/a、hey/abc、hey/abc/a都会被匹配忽略。

2. 为何hey/与hey效果一致？ #

在Git的.gitignore规则里，hey会被Git识别为既可匹配名为hey的文件，也可匹配名为hey的目录；而hey/是明确指定匹配目录。但在忽略目录及其内容的场景下，两者最终效果一致——因为一旦目录被标记为忽略，Git会自动忽略该目录下的所有内容，不管是直接写目录名还是带斜杠的目录名，都会触发整个目录的忽略逻辑。

唯一细微区别是：如果项目中存在同名文件hey（非目录），hey会忽略这个文件，而hey/只会忽略目录，不会影响同名文件。但在目标为忽略子目录的场景下，两者效果无差异。

3. 忽略指定子目录及内容的最佳实践 #

优先使用hey/，原因如下：

• 语义明确：明确指定忽略的是目录，避免意外忽略同名文件
• 性能更优：Git处理目录规则时，直接标记整个目录为忽略，无需遍历匹配内部文件，比hey/**的递归匹配效率更高
• 规则简洁：写法直观，不容易出错，也兼容所有Git版本

内容的提问来源于stack exchange，提问作者Isin Altinkaya