Git 2.40稀疏检出负模式告警疑问：为何无效模式仍生效？

问题背景 #

使用Git 2.40版本，仓库目录结构如下：

└── root_dir1
│   ├── dir11              
│   │   └── file11
│   │
│   └── dir12
│   │   └── file12
│   │   
│   └── file13
│
└── root_dir2
    ├── dir21         
    │   └── sub_dir21a
    │   │   │
    │   │   └── file21
    │   │   
    │   └── file22
    │
    └── file23

需求 #

• 仅检出root_dir1下的直接文件（排除所有子文件夹及内容），即file13
• 仅检出root_dir2下的直接文件、dir21下的直接文件（排除其他子文件夹及内容），即file22和file23

操作过程 #

先执行稀疏克隆和初始配置：

git clone --no-checkout --sparse repo_URL
git sparse-checkout set root_dir1 root_dir2
git checkout

随后编辑.git/info/sparse-checkout文件，内容如下：

/*
!/*/
/root_dir1/
/root_dir2/
#added some negative patterns
!/root_dir1/*/
!/root_dir2/dir21/*/

执行git sparse-checkout reapply时收到警告：

warning: unrecognized negative pattern: '/root_dir2/dir21/*' warning:
disabling cone pattern matching

最终结果符合需求，但存在疑问：

1. 负模式的问题出在哪？
2. 为什么!/root_dir1/*/有效，!/root_dir2/dir21/*/却触发警告？
3. 明明有警告，结果却正确的原因是什么？

问题解析 #

1. 负模式不兼容的核心原因：锥形模式的规则限制 #

Git 2.25+默认启用锥形模式匹配（cone pattern matching），这种模式为了提升性能，对路径模式有严格限制：

• 正模式只能是目录前缀（如/root_dir1/），或通配符仅在路径末尾（如/root_dir1/*）
• 负模式只能针对已被正模式包含的顶层目录的直接子项，不能嵌套到更深层级的子目录

你的!/root_dir1/*/能被识别，是因为它针对的是root_dir1的直接子目录，属于正模式/root_dir1/的直接下级，符合锥形模式规则；而!/root_dir2/dir21/*/是针对root_dir2/dir21下的子目录，属于嵌套层级，锥形模式不支持这种跨层级的负模式，因此抛出警告，并自动切换到非锥形模式（non-cone pattern）。

2. 结果符合预期的原因 #

当Git检测到不符合锥形模式的规则时，会自动禁用锥形模式，转而使用旧的非锥形模式匹配。非锥形模式支持更灵活的路径通配符，你的!/root_dir2/dir21/*/在这种模式下是完全有效的，所以最终能正确过滤掉不需要的子文件夹，得到你需要的文件。

3. 合规的修正方案（避免警告+保留锥形模式性能） #

如果想消除警告，同时保留锥形模式的性能优势，可以调整.git/info/sparse-checkout的内容为：

/root_dir1/*
!/root_dir1/*/
/root_dir2/*
/root_dir2/dir21/*
!/root_dir2/dir21/*/

规则解释：

• /root_dir1/*：包含root_dir1下的所有直接文件和子目录
• !/root_dir1/*/：排除root_dir1下的所有子目录（及其内容）
• /root_dir2/*：包含root_dir2下的所有直接文件和子目录
• /root_dir2/dir21/*：额外包含dir21下的所有直接文件和子目录
• !/root_dir2/dir21/*/：排除dir21下的所有子目录（及其内容）

所有模式均符合锥形规则，不会触发警告，同时完全满足你的检出需求。

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