ControlNet插件未启用需按六步解决：一、通过WebUI Extensions安装；二、从Git URL安装；三、手动解压安装；四、命令行Git克隆；五、下载并放置.pth与.yaml模型至models目录；六、在文生图中启用、上传参考图、匹配预处理器与模型、设参数后生成。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已安装 Stable Diffusion WebUI，但 ControlNet 插件尚未启用或无法正常调用，则可能是插件未正确安装、模型缺失或界面未正确加载。以下是解决此问题的步骤：
一、ControlNet 插件安装（四种方法）
插件安装需确保与当前 WebUI 版本兼容，且路径放置准确。不同网络环境适用不同安装方式，任选其一即可完成部署。
1、打开 Stable Diffusion WebUI，点击顶部菜单栏的 Extensions → Available，等待插件列表加载完成。
2、在页面右上角点击 Load from 按钮，确认 Extension index URL 已填充默认地址（如未填充，可手动输入 https://raw.githubusercontent.com/AUTOMATIC1111/stable-diffusion-webui/master/extensions-builtin/index.json）。
3、按下 Ctrl + F 调出搜索框，输入 controlnet，定位到 sd-webui-controlnet 插件条目。
4、点击右侧 Install 按钮，待提示“Installed”后，点击页面上方黄色按钮 Apply and restart UI 重启界面。
二、从 Git 仓库网址安装
该方式支持后续自动更新，推荐长期使用用户采用，避免手动拉取新版本。
1、进入 Extensions → Install from URL 标签页。
2、在 Extension's git repository URL 输入框中粘贴：https://github.com/Mikubill/sd-webui-controlnet.git。
3、点击 Install，等待安装日志显示 Installed into .../extensions/sd-webui-controlnet。
4、切换至 Installed 标签页，点击 Check for updates，再点击 Apply and restart UI。
三、手动解压安装（离线/受限网络适用）
适用于无法访问 GitHub 或 HuggingFace 的环境，需自行下载并校验文件完整性。
1、访问 GitHub 仓库：https://github.com/Mikubill/sd-webui-controlnet，点击右侧绿色 Code → Download ZIP。
2、解压 ZIP 文件，得到名为 sd-webui-controlnet 的文件夹。
3、将其完整复制至 WebUI 根目录下的 extensions/ 文件夹内（路径示例：stable-diffusion-webui/extensions/sd-webui-controlnet）。
4、完全关闭 WebUI 进程（包括后台 Python 进程），重新启动 WebUI。
四、通过命令行 Git 克隆安装
适合熟悉终端操作的用户，可确保获取最新开发分支代码，便于调试或测试预发布功能。
1、打开文件管理器，进入 WebUI 的 extensions/ 目录。
2、在地址栏输入 cmd 并回车，弹出命令行窗口。
3、执行命令：git clone https://github.com/Mikubill/sd-webui-controlnet.git。
4、等待克隆完成，关闭命令行，重启 WebUI。
五、ControlNet 模型下载与放置
插件仅提供控制逻辑框架，实际功能依赖外部 .pth 和 .yaml 模型文件。缺少任一类型文件均会导致预处理器不可用或报错。
1、访问 Hugging Face 官方模型库：https://huggingface.co/lllyasviel/ControlNet/tree/main/models。
2、下载至少两个基础模型：control_v11p_sd15_canny.pth 与 control_v11p_sd15_openpose.pth，及其对应同名 .yaml 文件。
3、将所有下载的 .pth 和 .yaml 文件放入：extensions/sd-webui-controlnet/models/ 目录。
4、重启 WebUI 后，在文生图界面底部展开 ControlNet 面板，确认下拉菜单中出现多个模型选项且无红色报错提示。
六、ControlNet 基础使用流程
启用 ControlNet 后，需配合参考图、预处理器与模型协同工作，每一步参数设置直接影响输出稳定性与可控性。
1、在文生图界面底部找到 ControlNet 折叠面板，勾选 Enable 开关。
2、点击画板图标或直接拖入一张参考图（建议分辨率不低于 512×512，格式为 PNG/JPG）。
3、在 Preprocessor 下拉菜单中选择与目标效果匹配的提取方式，例如：上传人物图选 openpose，线稿图选 canny。
4、在 Model 下拉菜单中选择对应名称的模型，确保与预处理器一致（如 openpose 预处理器必须配 openpose 模型）。
5、设置 Weight 值为 1.0 作为起始点，Resize mode 保持 Scale to fit (Inner Fit)。
6、输入正向提示词（如 a cyberpunk street at night, neon lights, rain puddles），点击生成按钮。
