Stable Diffusion WebUI更新需分五步：一、git pull更新主程序；二、运行update脚本自动更新；三、手动进入插件目录git pull更新单个扩展；四、通过WebUI扩展管理器批量更新已启用插件；五、删除损坏插件后重装。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您正在使用Stable Diffusion WebUI，但发现界面功能陈旧、模型加载失败或插件报错，则可能是WebUI核心版本或已安装扩展插件未同步最新变更。以下是更新SD WebUI主程序及各类扩展插件的具体操作步骤：
一、更新WebUI主程序（基于git方式）
该方法适用于通过git克隆方式部署的WebUI，可完整拉取官方仓库最新提交，保留原有配置与模型路径，避免重装风险。
1、打开命令行终端（Windows用户使用CMD或PowerShell，macOS/Linux用户使用Terminal）。
2、切换至Stable Diffusion WebUI安装目录，例如：cd /path/to/stable-diffusion-webui。
3、执行拉取最新代码命令：git pull origin master。
4、若提示存在本地修改冲突，先运行：git stash暂存更改，再执行pull，完成后运行：git stash pop恢复自定义文件。
5、重新启动WebUI，验证版本号是否更新：启动后查看控制台首行输出的commit hash或访问“设置→关于”页面确认版本信息。
二、更新WebUI主程序（基于一键脚本方式）
该方法适用于Windows平台使用webui-user.bat或Linux/macOS使用webui.sh启动的用户，利用内置update脚本自动处理依赖与子模块。
1、关闭正在运行的WebUI进程。
2、在WebUI根目录下，Windows用户双击运行：update-webui.bat；Linux/macOS用户在终端中执行：./webui.sh --update。
3、等待脚本完成所有git pull、pip install及extensions子模块更新操作。
4、脚本结束后，直接重新运行webui.bat或webui.sh启动界面。
三、手动更新单个扩展插件
当仅需更新特定扩展（如ControlNet、ADetailer）且不希望影响其他插件时，可进入对应扩展目录单独执行git更新。
1、定位扩展所在路径：stable-diffusion-webui/extensions/插件文件夹名（例如extensions/sd-webui-controlnet）。
2、进入该目录后执行：git pull origin main（部分插件分支为master或dev，请先用git branch -a确认默认分支）。
3、若插件含额外Python依赖，查看其requirements.txt，手动执行：pip install -r requirements.txt（建议在WebUI虚拟环境中运行）。
4、重启WebUI，进入“扩展→已安装”列表检查插件状态是否显示“已启用”且无黄色警告图标。
四、批量更新全部已启用扩展
WebUI内置扩展管理器支持统一更新所有已启用插件，无需逐个进入目录操作，适合维护多个插件的用户。
1、启动WebUI并登录界面，点击顶部导航栏的扩展选项卡。
2、切换到已安装子页，勾选所有需更新的扩展左侧复选框。
3、点击页面底部的应用所选操作按钮，下拉菜单中选择更新。
4、等待右上角通知栏显示“全部扩展更新完成”，刷新页面确认各插件版本号已变更。
五、强制重置并重新安装扩展（解决更新失败）
当某扩展更新后出现ImportError、AttributeError或界面元素丢失，说明本地文件损坏或分支异常，需彻底清理后重装。
1、关闭WebUI，进入stable-diffusion-webui/extensions/目录。
2、删除问题插件对应文件夹（例如删除sd-webui-depth-lib）。
3、重启WebUI，进入“扩展→可用”页，搜索该插件名称，点击安装按钮重新获取最新发布版。
4、安装完成后，点击应用设置并重启使插件生效。
