如何从Git远程仓库复制指定commit hash下的文件到本地临时目录

错误原因 #

你遇到的[Errno 2] No such file or directory报错由两个核心问题导致：

• shutil.copyfile 仅支持本地文件系统路径，无法直接读取HTTPS协议的远程仓库资源
• git fetch命令的输出不是文件路径，将命令输出直接拼接为远程文件路径本身就不合法

可用实现方案 #

推荐优先使用git archive命令实现，无需逐文件处理，效率更高：

方案1：已存在本地仓库时使用 #

直接从本地仓库导出指定commit的全量文件到目标临时目录：

import subprocess
import os

# 替换为你的实际参数
local_repo_path = "/本地仓库的存储路径"
target_commit = "你需要导出的commit hash"
temp_folder = "./local_dir/temp_folder"

# 提前创建目标临时目录
os.makedirs(temp_folder, exist_ok=True)

# 执行导出逻辑
archive_proc = subprocess.run(
    ["git", "archive", target_commit],
    cwd=local_repo_path,
    check=True,
    stdout=subprocess.PIPE
)
subprocess.run(
    ["tar", "-x", "-C", temp_folder],
    check=True,
    input=archive_proc.stdout
)

方案2：无本地仓库，直接从远程导出 #

如果没有提前克隆仓库，可直接调用git archive访问远程仓库导出：

import subprocess
import os

# 替换为你的实际参数
remote_repo_url = f"https://{username}:{password}@{remote_dir}"
target_commit = "你需要导出的commit hash"
temp_folder = "./local_dir/temp_folder"

os.makedirs(temp_folder, exist_ok=True)

archive_proc = subprocess.run(
    ["git", "archive", f"--remote={remote_repo_url}", target_commit],
    check=True,
    stdout=subprocess.PIPE
)
subprocess.run(
    ["tar", "-x", "-C", temp_folder],
    check=True,
    input=archive_proc.stdout
)

方案3：远程仓库禁用git archive时的备用方案 #

如果远端仓库不支持git archive远程调用，可以通过浅克隆拉取目标commit后再复制文件：

import subprocess
import os
import shutil
import tempfile

# 替换为你的实际参数
remote_repo_url = f"https://{username}:{password}@{remote_dir}"
target_commit = "你需要导出的commit hash"
temp_folder = "./local_dir/temp_folder"

os.makedirs(temp_folder, exist_ok=True)

# 创建临时目录存储克隆的仓库，使用完自动清理
with tempfile.TemporaryDirectory() as tmp_clone_path:
    # 浅克隆，仅拉取最少必要内容，减少拉取耗时
    subprocess.run(
        ["git", "clone", "--depth", "1", "--no-checkout", remote_repo_url, tmp_clone_path],
        check=True
    )
    # 检出目标commit
    subprocess.run(
        ["git", "checkout", target_commit],
        cwd=tmp_clone_path,
        check=True
    )
    # 复制所有非.git文件到目标临时目录
    for item in os.listdir(tmp_clone_path):
        src_path = os.path.join(tmp_clone_path, item)
        dest_path = os.path.join(temp_folder, item)
        if item == ".git":
            continue
        if os.path.isdir(src_path):
            shutil.copytree(src_path, dest_path, dirs_exist_ok=True)
        else:
            shutil.copy2(src_path, dest_path)

注意事项 #

• 所有subprocess调用推荐使用列表形式传参，不要开启shell=True，避免注入风险，也能兼容带特殊字符的路径参数
• Windows环境如果没有内置tar命令，可以用Python内置的tarfile模块处理git archive返回的二进制流，无需依赖系统工具

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