stable diffusion webui error code 128怎么办?如何修复?

大家好，我是Stable Diffusion中文网的站长小庞。很多新手装 Stable Diffusion WebUI 时，明明前面步骤都照着教程做，双击 webui-user.bat 后却突然跳出 stable diffusion webui error code 128，心态直接崩了。这个报错通常不是模型坏了，也不是你电脑“不能玩AI绘画”，更常见的原因是 WebUI 在下载或更新依赖仓库时失败了。WebUI 可以理解成“AI绘画的遥控器”，它要把后台工具叫起来才能正常工作；今天我就用大白话带你按顺序排查，尽量少走弯路。

stable diffusion webui error code 128怎么办?如何修复?

stable diffusion webui error code 128到底是什么意思？

stable diffusion webui error code 128通常和 Git 拉取、更新代码失败有关。简单说，WebUI 启动时会检查一些依赖项目，如果某个仓库没下载完整、网络连不上、文件夹损坏，Git 就可能返回 128；Git 可以理解成“代码快递员”，128 就像快递员说“这个包裹我没取到或送不完整”。

stable diffusion webui error code 128不一定代表你的 Stable Diffusion WebUI 安装彻底失败。很多时候它只是卡在 repositories 目录、扩展插件更新、网络连接、权限路径这些位置；repositories 文件夹可以理解成“工具零件箱”，里面有 WebUI 运行时需要调用的一些组件，零件箱缺件或半路下载断了，启动就容易报错。

如果报错出现在首次安装阶段，优先怀疑网络下载依赖失败。
如果之前能用，突然报错，优先怀疑插件或 repositories 目录更新异常。
如果换过安装目录，优先检查路径里是否有中文、特殊符号或权限限制。
如果提示和 Git、clone、fetch、checkout 相关，基本可以按 Git 仓库问题排查。

stable diffusion webui error code 128先按这个顺序排查

stable diffusion webui error code 128排查时不要一上来就重装系统，也不要乱删 Python、CUDA。建议先关闭 WebUI，再进入 stable-diffusion-webui 主目录，找到 repositories 文件夹，把它改名备份或删除，然后重新运行 webui-user.bat，让 WebUI 重新下载依赖；这个方法在很多安装场景里都有效，但前提是你的网络能正常访问对应资源。

stable diffusion webui error code 128如果删除 repositories 后过一会儿又出现，通常说明根因还在网络或 Git 环境。你可以检查电脑是否安装了 Git、是否被安全软件拦截、是否使用了不稳定代理、安装目录是否太深。模型路径可以理解成“你把画材放在哪个柜子里”，路径太奇怪、权限不够，软件找东西时就容易出岔子。

第一步：关闭正在运行的 WebUI 窗口，避免文件被占用。
第二步：进入 stable-diffusion-webui 文件夹，找到 repositories 文件夹。
第三步：把 repositories 改名为 repositories_bak，或确认不需要后删除。
第四步：重新双击 webui-user.bat，观察是否重新下载并继续启动。
第五步：如果仍报 128，再检查 Git、网络、权限和插件更新问题。

stable diffusion webui error code 128如果你是在跟着教程做 Stable Diffusion安装、本地部署、WebUI安装时遇到的，建议对照 Stable Diffusion中文网安装专题页检查基础环境。尤其是 Windows 用户，安装包、启动器、环境配置和模型安装位置最好保持清晰，不要把多个整合包混在一个目录里。

stable diffusion webui error code 128常见原因和对应修复办法

stable diffusion webui error code 128最常见的原因是依赖仓库没有完整下载。你看到的可能不是“128”三个字本身，而是前面夹着 clone failed、fatal、repository、submodule、checkout 等提示；这类提示的重点不是背英文，而是判断它卡在“下载代码”还是“读取本地文件”。

stable diffusion webui error code 128也可能和插件安装有关。插件就像给 WebUI 加的小工具，能增强功能，但如果插件仓库下载失败、版本不兼容，启动时也可能触发 Git 相关错误；所以排查时可以临时把 extensions 文件夹里的新装插件移走，再启动测试。

网络不稳定：换一个更稳定的网络环境，避免下载依赖时中断。
Git 未正确安装：确认系统能正常调用 Git，安装后建议重启电脑再试。
repositories 损坏：备份或删除 repositories 文件夹，让 WebUI 重新生成。
插件导致报错：临时移走最近安装的插件，再启动 WebUI 判断。
目录权限问题：把 WebUI 放到英文路径，例如磁盘根目录下的独立文件夹，避免中文和特殊符号。

stable diffusion webui error code 128如果和显卡报错、CUDA报错、启动失败混在一起出现，要分清先后顺序。显存可以理解成“AI绘画时的临时桌面”，桌面太小会影响出图，但 128 更多是下载和仓库问题；如果日志前半段已经卡在 Git，就先修 Git，不要急着改显卡参数。

stable diffusion webui error code 128修复后还要注意什么？

stable diffusion webui error code 128修复后，建议先用默认设置启动一次，不要马上安装一堆插件和模型。Checkpoint 可以理解成“画师的大脑风格包”，LoRA 像“给画师加的小技能贴纸”，VAE 像“最后调色的滤镜”，这些资源本身不该随便乱放，建议按 WebUI 对应文件夹存放，避免后续又出现路径混乱。

stable diffusion webui error code 128修复后，如果你不想反复折腾环境，或者电脑没有合适显卡，也可以先用 Stable Diffusion中文网官方在线生图平台体验提示词、图生图和基础出图流程。采样器可以理解成“画图时下笔的方式”，新手先把提示词、尺寸、步数这些基础项摸熟，再回头本地部署会轻松很多。

不要同时混用多个来源不明的整合包，容易造成文件重复和环境冲突。
不要看到报错就乱改启动脚本，先保存原文件再尝试调整。
不要下载来路不明的所谓破解版、免限制版本，建议使用正规开源项目和合规平台。
不要把模型、插件、WebUI 主程序塞进中文很长的目录，排错会更麻烦。

stable diffusion webui error code 128如果反复出现，建议把报错日志从最早的 fatal、clone、Git 相关位置开始看，而不是只盯最后一行。需要重新配置环境、检查配置要求、处理显存不足或启动失败问题时，也可以继续参考 Stable Diffusion中文网安装专题页，按步骤排查会比东改一下西删一下更稳。

总的来说，stable diffusion webui error code 128大多不是模型本身的问题，而是 Git 下载依赖、repositories 文件夹、插件仓库、网络或路径权限出了状况。小庞建议你先备份或重建 repositories，再检查 Git 和网络，最后再排查插件与路径；如果只是想先体验 AI 绘画效果，可以先用在线方式熟悉流程，再决定是否本地部署。后续遇到安装、模型、提示词和工作流问题，也欢迎来 Stable Diffusion中文网继续交流。

原创文章，作者：SD中文网，如若转载，请注明出处：https://www.stablediffusion-cn.com/sd/23048.html

加入Stable Diffusion交流群