Git拉取失败需分步排查:先验证git --version是否在PATH,未识别则重装并勾选“Add Git to PATH”;若已识别但卡在Cloning,先执行git config --global http.sslVerify false绕过SSL重置;仍失败则配置http/https代理;最后可改用Gitee镜像克隆或GitHub ZIP解压(须删除.git文件夹)。

Windows系统安装Stable Diffusion时,Git拉取仓库失败导致卡在“Cloning…”,后续依赖无法安装,WebUI根本启动不了。
确认Git是否真正可用
按 Win + R 输入 cmd 回车,执行:
git --version
如果提示“不是内部或外部命令”,说明Git未加入系统环境变量——此时必须重装Git并勾选“Add Git to the system PATH”(安装向导第3步,默认是“Use Git from Windows Command Prompt”选项)。
若已显示版本号(如 git version 2.43.0),但拉取仍报错,则进入下一步排查。
关闭SSL证书校验(应对Connection was reset)
在Git Bash或CMD中执行:
git config --global http.sslVerify false
这一步能绕过国内网络环境下GitHub HTTPS连接被重置的问题。注意:【该设置仅限本地安装阶段使用,切勿长期开启】,安装成功后建议恢复:git config --global http.sslVerify true。
执行后无需重启终端,直接试拉一次验证:
git clone https://github.com/AUTOMATIC1111/stable-diffusion-webui.git test-repo
若出现“Cloning into 'test-repo'…”且开始下载,说明生效;若仍失败,继续看下一条。
手动配置Git代理(适用于启用代理但未同步到Git)
第一步:查清你当前浏览器/系统使用的代理地址和端口(例如:127.0.0.1:7890)
第二步:在CMD中依次运行:
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890
第三步:验证代理是否生效:
curl -I https://github.com
如果返回HTTP 200或302,说明代理通了;如果报错“Failed to connect”,请检查代理软件是否正在运行、端口是否被占用、防火墙是否拦截。代理配置错误会导致所有git操作静默失败,比无代理更难排查。
换源克隆(当GitHub完全不可达时的兜底方案)
方法一:用Gitee镜像站(需提前有人同步)
访问 https://gitee.com/mirrors/stable-diffusion-webui → 点击“克隆/下载”→复制HTTPS地址→在目标文件夹右键“Git Bash Here”→执行:
git clone https://gitee.com/mirrors/stable-diffusion-webui.git
方法二:直接下载ZIP解压(跳过git)
打开 GitHub 项目页 → 点击绿色 Code 按钮 → Download ZIP → 解压到硬盘空闲空间 ≥20GB 的路径(如 D:\sd-webui)→ 进入该文件夹,双击 webui-user.bat 启动。
注意:【解压后首次运行仍会尝试git pull更新,需提前删掉文件夹内 .git 目录,否则会报错退出】。删除方法:显示隐藏文件 → 进入解压目录 → 找到并彻底删除名为 .git 的文件夹(不是.gitignore)。


















