Python subprocess调用Git Bash批量克隆GitLab仓库失败如何解决

问题根因 #

你之前的写法存在3个核心错误：

• 错误调用了带GUI的git-bash.exe：这个程序是Git自带的交互终端模拟器，不是用来做脚本执行的命令行解释器，不会正确透传传入的命令/脚本参数，要么启动后空开窗口，要么直接崩溃退出。
• Shell脚本写法错误：你写的占位脚本仅包含$1且未加引号，传入带空格的git clone xxx命令时，只会识别到第一个参数git，后续的clone和仓库名参数会被直接丢弃，执行必然报错。
• subprocess参数规则使用错误：第二种写法把完整git命令作为第一个位置参数、把git-bash路径设为executable的写法完全不符合参数传递逻辑，程序根本拿不到要执行的指令。

正确实现方案 #

不需要额外创建Shell脚本，直接调用Git安装目录下无GUI的原生Bash解释器即可，注意解释器路径是Git安装目录下usr/bin/bash.exe，和你之前用的git-bash.exe在同一根目录下。
可直接运行的参考代码：

import subprocess

# 按需修改以下配置项
BASH_PATH = "C:/Users/my_user_name/AppData/Local/Programs/Git/usr/bin/bash.exe"
SAVE_DIR = "C:/Users/my_user_name/Documents/Gitlab Repos"
GITLAB_PREFIX = "https://url_to_my_gitlab_server/"
repo_list = [list_with_all_repository_names]

for repo_name in repo_list:
    repo_url = f"{GITLAB_PREFIX}{repo_name}.git"
    # 通过bash -c参数直接传入要执行的克隆命令
    proc = subprocess.run(
        [BASH_PATH, "-c", f"git clone {repo_url}"],
        cwd=SAVE_DIR,
        capture_output=True,
        text=True
    )
    # 打印执行日志方便排查问题
    print(f"仓库{repo_name}处理完成，返回码：{proc.returncode}")
    if proc.stdout:
        print("标准输出：", proc.stdout)
    if proc.stderr:
        print("错误输出：", proc.stderr)

注意事项 #

• 不需要加time.sleep(20)这类固定等待：subprocess.run本身是阻塞调用，会等当前克隆命令完全执行结束后才会进入下一轮循环，固定等待既会拖慢整体速度，网络差时也可能因为等待时长不足出问题。
• 提前配置好GitLab鉴权：要么在Windows凭据管理器中保存GitLab的账号/访问令牌，要么配置SSH密钥改用SSH格式的克隆地址，也可以直接把凭据写到URL中，格式为https://<用户名>:<个人访问令牌>@url_to_my_gitlab_server/{repo_name}.git，避免程序卡在密码输入环节挂起。
• 如果确实需要使用独立Shell脚本，不要直接写$1，要改成eval "$1"来完整执行传入的命令字符串，同时调用时仍然要使用usr/bin/bash.exe作为执行程序，不要用git-bash.exe。

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