Git checkout带排除项在分支非本地时失败的原因及解决方法

我尝试检出一个分支，但希望排除README.md和CHANGELOG.md文件，遇到了如下两种不同结果的操作：

可行操作 #

git clone [url] --no-checkout .
git checkout BranchnameA
git checkout BranchnameB # 任意其他分支
git checkout BranchnameA ':^README.md' ':^CHANGELOG.md'

执行后，BranchnameB中的README.md和CHANGELOG.md会被保留，不会被BranchnameA的对应文件覆盖。

不可行操作 #

git clone [url] --no-checkout .
git checkout BranchnameA ':^README.md' ':^CHANGELOG.md'

执行后触发报错：

error: pathspec 'BranchnameA' did not match any file(s) known to git
error: pathspec ':^README.md' did not match any file(s) known to git
error: pathspec ':^CHANGELOG.md' did not match any file(s) known to git

两种操作的核心区别是：可行操作中BranchnameA是本地已存在的分支，不可行操作中该分支仅存在于远程、未在本地创建。

疑问 #

为什么使用排除模式检出分支时需要本地分支？是否有无需提前创建本地分支的解决办法？我曾尝试sparse-checkout，但不符合需求。

原因解析 #

Git的git checkout <branch> <pathspec>语法中，当你同时指定分支名和路径模式时，Git需要先确认<branch>是本地已存在的分支引用。如果目标分支仅存在于远程，Git会将BranchnameA当作文件路径而非分支名解析，自然匹配不到对应内容，从而抛出路径不匹配的错误。

简单来说，这种带排除规则的检出逻辑，依赖本地分支的树对象来筛选文件，因此要求目标分支必须已在本地创建。

替代解决办法 #

无需提前完整检出分支，可直接从远程分支获取内容并排除指定文件：

1. 先拉取远程分支的引用到本地：

git fetch origin BranchnameA

2. 直接从远程分支检出除指定文件外的所有内容：

git checkout origin/BranchnameA -- . ':^README.md' ':^CHANGELOG.md'

执行后，工作区会获取BranchnameA的所有内容，但不会覆盖或创建README.md和CHANGELOG.md。

如果后续需要将当前工作区状态关联到本地分支，可执行：

git checkout -b BranchnameA origin/BranchnameA

此时本地分支会与远程分支关联，且工作区已保留排除指定文件的状态。

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