SD WebUI 启动卡在 loading model 通常是因为显存不足或模型文件损坏，最直接的修复是在启动参数中添加显存优化指令。此方法适用于显存小于 8GB 的显卡场景，风险是生成速度可能下降。
先说结论：大部分卡住问题源于显存分配失败，优先调整启动参数而非重装软件。
- 先确认控制台报错信息是否包含 CUDA 或 OOM 关键字
- 先处理 webui-user.bat 中的 COMMANDLINE_ARGS 参数
- 再验证启动后日志是否不再重复加载模型
快速处理思路
直接修改启动脚本中的参数变量是最快恢复启动的方法。
找到 SD WebUI 根目录下的 webui-user.bat 文件，右键选择编辑。定位到 set COMMANDLINE_ARGS= 这一行，在末尾添加 `--medvram` 或 `--lowvram`。保存文件后双击运行脚本，观察启动过程是否跳过卡死阶段。
为什么会这样
核心原因是显存不足以一次性加载模型权重或计算图。
Stable Diffusion 模型文件通常在 2GB 到 7GB 之间，加载时需要额外显存存放中间计算数据。当显卡物理显存小于模型需求时，PyTorch 会尝试分配内存失败，导致进程挂起等待资源释放。添加显存优化参数后，程序会将部分计算任务转移到系统内存，从而避免显存溢出导致的卡死。
分步处理
按照日志报错、参数调整、文件检查的顺序执行排查。
步骤 1：查看控制台日志
启动 SD WebUI 时不要最小化黑色命令行窗口。观察最后停住的日志行。如果显示 CUDA out of memory 或长时间停在 Loading model... 无后续输出，确认为显存或加载问题。
步骤 2：调整启动参数
编辑 webui-user.bat（Windows）或 webui-user.sh（Linux）。在 COMMANDLINE_ARGS 中追加参数。显存 4GB 推荐 `--lowvram`，显存 6GB 推荐 `--medvram`。若使用 NVIDIA 显卡且遇到半精度错误，可追加 `--no-half`。
步骤 3：检查模型文件完整性
进入 models/Stable-diffusion 目录，检查卡住的模型文件大小。若文件大小为 0KB 或明显小于正常值（如 SD1.5 应为 4GB 左右），说明下载未完成。删除该文件并重新下载。
步骤 4：禁用冲突扩展
若参数调整无效，临时重命名 extensions 文件夹为 extensions_backup。重启 SD WebUI。若启动成功，说明是某个扩展插件导致加载阻塞，需逐个排查。
怎么验证是否生效
观察控制台日志是否出现 Model loaded successfully 字样。
成功启动的标志是命令行窗口最后显示 Startup time: xx.xx s 以及 http://127.0.0.1:7860 地址。浏览器访问该地址能正常看到绘图界面，且顶部模型选择栏可切换。若控制台不再滚动报错且 CPU/显卡占用率回落至 idle 状态，说明模型加载已完成。
常见坑
路径编码和驱动版本是导致隐性失败的两大主因。
SD WebUI 对中文路径支持不佳，安装目录包含中文字符可能导致模型路径读取失败而卡住。NVIDIA 显卡驱动版本过低会导致 CUDA 初始化失败，建议更新至最新稳定版驱动。不要在同一个目录下同时运行多个 SD WebUI 实例，端口冲突会导致第二个实例无法加载模型。
常见问题
添加显存参数会影响出图质量吗
不会影响生成图像的像素质量，仅可能降低生成速度。
`--medvram` 和`--lowvram` 有什么区别
`--medvram` 适度优化显存占用，`--lowvram` 极度优化但速度更慢，根据显存大小选择。
模型文件下载一半卡住怎么办
删除未完成文件，使用支持断点续传的工具重新下载完整模型文件。
参考来源
Automatic1111 GitHub Wiki - Command Line Arguments and Options
URL: https://github.com/AUTOMATIC1111/stable-diffusion-webui/wiki/Command-Line-Arguments-and-Options