Git稀疏检出在Windows机器报错，如何配置兼容原有命令？

问题场景 #

我在Windows环境下使用以下Git命令实现仓库稀疏检出文件夹：

git clone --verbose --filter=blob:none --no-checkout --depth 1 --sparse "https://user:password@github.com/organization/repo-name.git"

cd ./repo-name

git config core.sparseCheckout true

git sparse-checkout init
git sparse-checkout add /MainFolder !/MainFolder/Subfolder
git sparse-checkout add /AnotherFolder
...
git checkout --progress --force
...

这些命令在我的机器上运行正常，但在另一台Windows机器的Powershell或CMD中执行时，出现报错：

fatal: specify directories rather than patterns.  If your directory starts with a '!', pass --skip-checks

排查发现 #

经测试，git sparse-checkout add MainFolder可正常执行，但带前置斜杠的git sparse-checkout add /MainFolder会报错：fatal: specify directories rather than patterns (no leading slash)。两台机器使用的Git版本均为git version 2.37.1.windows.1。

解决方案 #

问题根源是Git稀疏检出的cone模式限制：上述命令属于pattern风格的规则，而cone模式仅支持简单的目录指定，不支持前置斜杠、!排除等模式语法。需关闭cone模式才能正常运行，有两种配置方式：

方式一：通过config命令配置 #

先执行以下配置命令：

git config core.sparseCheckout true
git config --worktree core.sparsecheckoutcone false

再初始化稀疏检出：

git sparse-checkout init

方式二：直接使用set命令 #

用一条命令替代所有配置和初始化步骤：

git sparse-checkout set --no-cone

关闭cone模式后，即可正常使用带前置斜杠的目录指定、!/folder这类排除规则的稀疏检出命令。

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