如何阻止git archive操作与远程仓库通信？

问题根源 #

你使用git clone --filter=blob:none创建的是仅包含元数据的轻量克隆——只拉取了提交记录、树结构等信息，没有实际的文件内容（blob对象），LFS文件也仅存储了指针而非实际数据。当git archive需要生成包含文件内容的归档时，Git会自动从远程仓库拉取缺失的对象，这就是你看到远程通信的原因。

实现纯本地归档的方案 #

要让git archive完全本地操作，核心是确保本地已拥有HEAD对应的所有必要数据，同时禁止Git自动从远程补全缺失对象。

方案1：调整克隆命令，直接拉取完整内容 #

放弃--filter=blob:none，改用浅克隆拉取目标提交的完整文件内容：

# 克隆指定分支的最新提交（仅拉取1层深度）
git clone --depth 1 --branch $BRANCH $REPO .
# 若目标提交不是分支顶端，拉取该提交的完整数据并创建临时分支
git fetch origin $COMMIT:refs/heads/temp_commit
git checkout -f temp_commit
# 可选：清理临时分支
git branch -D temp_commit

完成后本地已包含该提交的所有文件内容，后续执行git archive无需远程通信。

方案2：在现有克隆基础上补拉数据并禁用远程获取 #

如果必须保留--filter=blob:none的克隆方式，先手动拉取HEAD对应的blob对象，再禁用远程自动补全：

# 拉取当前HEAD所需的所有blob对象到本地
git fetch origin $COMMIT --no-tags --filter=blob:none --fetch-if-missing=false
# 禁止Git自动从远程获取缺失对象
git config --local remote.origin.skipFetchAll true
# 执行归档
git archive --format=tar --output=repo.tar HEAD

注意：如果本地仍缺失必要对象，禁用远程获取后git archive会因找不到数据报错。

方案3：仅阻止LFS文件的远程下载 #

如果只是不想拉取LFS大文件，可在checkout前禁用LFS自动同步：

git lfs install --skip-repo
git checkout -f $COMMIT
# 此时归档的是LFS指针文件而非实际大文件
git archive --format=tar --output=repo.tar HEAD

重要提示 #

如果本地没有HEAD对应的文件内容，又完全禁止远程通信，git archive无法生成包含实际文件的归档包——Git没有本地数据可用于归档。你需要在“获取必要本地数据”和“完全不远程通信”之间做权衡。

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