本地分支已同步时git diff为何仍尝试连接远程仓库？

本地已检出两个同步完成的分支，未连接VPN时执行git diff branchB，出现如下错误：

me@work:~/dev/project/myuberproject (branchA)
$ git diff branchB
ssh: Could not resolve hostname gitlab.ourgitlabserver.com: Name or service not known
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.
fatal: could not fetch e0e7c...2115 from promisor remote

疑问：为什么对比两个本地分支还需要连接远程？

核心原因：仓库使用了承诺式远程仓库（Promisor Remote） #

你的仓库是通过Git的**部分克隆（Partial Clone）**功能创建的，这种模式下Git不会一次性下载所有仓库对象，而是标记远程为「promisor」，仅在需要时才从远程拉取缺失的对象。

具体细节 #

• 当你执行git clone时如果使用了--filter参数（比如过滤大文件或历史对象），Git会将远程仓库标记为promisor，只下载当前工作必要的对象。
• 即便你认为分支已经同步，branchB中可能仍存在未本地缓存的对象（比如某个历史提交里的大文件、早期变更的 blob 对象），执行git diff时需要这些对象来完成对比，因此Git会尝试从远程拉取，未连接VPN时就会触发解析主机失败的错误。

验证方法 #

执行以下命令确认远程是否为promisor：

git rev-parse --is-promisor-remote origin

如果返回true，说明当前远程是promisor类型。

解决办法 #

1. 补全本地对象：连接VPN后，执行以下命令拉取所有缺失的对象，之后离线即可正常对比分支：

   git fetch --all --no-filter
   

2. 禁用部分克隆（可选）：如果不需要部分克隆的特性，可以重新克隆仓库时不添加--filter参数，或者通过上述git fetch --no-filter命令将现有仓库转换为完整克隆。

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